Modem MCP Server

Connect Modem to any MCP-compatible client. Modem builds a custom context graph of your customers and product, grouping disparate data from chat, issue trackers, and support inboxes into topics, people, and companies. From your assistant you can search that graph, run the Modem Agent, and update your workspace directly.

https://mcp.modem.dev/mcp

• Transport: Streamable HTTP
• Auth: OAuth 2.1 with Dynamic Client Registration — no API key to create or paste
• Docs: https://modem.dev/docs/api/modem-mcp-server

This repo holds the public manifests, install docs, and listing assets for the Modem MCP server. The server itself is a hosted service; there is nothing to run from this repo.

What you can do

Kind	Tools	Scope
Run the Modem Agent	modem_agent_invoke, modem_agent_get_run, modem_agent_send_message, modem_agent_cancel_run	agent:invoke
Search your data	search_modem — natural-language search over topics, messages, people, companies	data:read
Update your workspace	update_topic, bulk_update_topics, merge_topics, create_companies, update_companies, merge_companies, add_people_to_company, update_people, merge_people	agent:invoke

Write tools act as you, under your existing role in the organization you authorize — never more access than your Modem account already has. All writes are annotated destructive, so most clients confirm each call.

Install

In every client, the server URL is https://mcp.modem.dev/mcp. The first connection opens a browser window for OAuth authorization.

Claude Code

claude mcp add --transport http modem https://mcp.modem.dev/mcp

Then run /mcp inside Claude Code and complete the browser authorization flow.

Cursor

Or Settings → Cursor Settings → Tools & MCP → add a new MCP server, or add to mcp.json:

{
    "mcpServers": {
        "modem": {
            "url": "https://mcp.modem.dev/mcp"
        }
    }
}

If Cursor asks for a transport type, choose Streamable HTTP.

Grok Build and Grok chat

The Grok Build package is under plugins/grok, with local install and verification steps. Source PR #8 and xAI marketplace PR #907 are open for review. Native Build OAuth, tool discovery, and one read-only search passed a smoke test with Grok Build 1.0.41 on September 24, 2026.

For Grok chat, add a Custom connector at grok.com/connectors using https://mcp.modem.dev/mcp and complete authentication. OAuth and a read-only search passed in a demo test on September 24, 2026. Availability inside Grok on X remains unconfirmed. See Grok submission notes for the separate Build, chat, Bot, and X distribution paths.

VS Code / GitHub Copilot

In your user profile mcp.json or workspace .vscode/mcp.json:

{
    "servers": {
        "modem": {
            "type": "http",
            "url": "https://mcp.modem.dev/mcp"
        }
    }
}

Or use MCP: Add Server from the command palette.

Codex

codex mcp add modem --url https://mcp.modem.dev/mcp
codex mcp login modem

Or in ~/.codex/config.toml:

[mcp_servers.modem]
url = "https://mcp.modem.dev/mcp"
auth = "oauth"

auth defaults to oauth, so it can be omitted. If you edit config.toml directly, you still need codex mcp login modem to complete OAuth.

Gemini CLI

This repo is a Gemini CLI extension (see gemini-extension.json):

gemini extensions install https://github.com/modem-dev/mcp

Then authorize when prompted on first use (or run /mcp auth modem inside Gemini CLI).

opencode

In opencode.json:

{
    "$schema": "https://opencode.ai/config.json",
    "mcp": {
        "modem": {
            "type": "remote",
            "url": "https://mcp.modem.dev/mcp"
        }
    }
}

Then opencode mcp auth modem (or authorize when prompted on first use).

ChatGPT

ChatGPT connects to remote MCP servers through Developer mode, available on paid plans. Depending on your ChatGPT version the setting lives under Settings → Security and login, or under Apps (previously Connectors) → Advanced settings.

1. Enable Developer mode.
2. In the apps/connectors list, click the add (+) button to create a new connection.
3. Give it a name such as Modem and enter the server URL https://mcp.modem.dev/mcp.
4. If asked for an authentication type, choose OAuth. Create the connection.
5. Complete the Modem authorization flow in the browser window that opens, then review the discovered tools.

In a conversation, enable the Modem connection from the composer's tools menu. ChatGPT asks for confirmation before running write tools.

Any other MCP client

Field	Value
Name	modem
URL	https://mcp.modem.dev/mcp
Transport	Streamable HTTP (or "HTTP")
Authentication	OAuth

Example prompts

• "What are customers saying about billing in the last month?"
• "Summarize the three highest-priority open topics and who's affected."
• "Mark the topic about SSO login failures as high priority in Modem."
• "Find the duplicate Acme companies in Modem and merge them into the one with the acme.com domain."

Security and access

• OAuth tokens are scoped to the account and organization selected on the consent screen; the server resolves the organization from token claims, never from the URL.
• Two permissions, granted separately: data:read (natural-language search only) and agent:invoke (agent runs + workspace writes).
• Tool calls are rate limited per organization, per tool (20/min).
• Privacy policy: https://modem.dev/privacy-policy · Terms: https://modem.dev/terms-of-service · Trust center: https://trust.modem.dev

Support

Questions or issues: support@modem.dev

---

Plugin packages for Cursor, Claude Code, and Grok Build live in plugins/.