---
slug: "pi-modem-mcp-extension"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/tridha643/Pi-modem@main/README.md"
repo: "https://github.com/tridha643/Pi-modem"
source_file: "README.md"
branch: "main"
---
# Pi Modem MCP Extension

A project-local [Pi](https://pi.dev) extension that exposes Modem's remote MCP server as Pi tools.

## What it adds

- `invoke_modem_agent` — asks Modem's `invoke_modem_agent` MCP tool a self-contained natural-language question.
- `list_modem_mcp_tools` — lists Modem MCP tools and checks connectivity.
- `/modem-auth` — starts/validates browser OAuth authorization for Modem.
- `/modem-reset-auth` — clears saved OAuth credentials.

## Setup

```bash
cd .pi/extensions/modem-mcp
npm install
cd ../../..
pi
```

If Pi is already running, use `/reload` after installing dependencies.

The extension is auto-discovered from:

```text
.pi/extensions/modem-mcp/index.ts
```

OAuth credentials are stored outside the repo at:

```text
~/.pi/agent/modem-mcp-oauth.json
```

## Use

Run `/modem-auth` once, complete the browser consent flow, then ask Pi questions that require Modem. Pi can call `invoke_modem_agent` when it needs Modem customer-feedback data or connected-tool context.

Each Modem MCP call is self-contained, so prompts sent to Modem should include all needed context.

See `.pi/extensions/modem-mcp/README.md` for configuration options.