Skip to content

Clients overview

On this page you will learn which clients work with MMW, which connection method to choose and how the methods differ. Step-by-step instructions are on each client’s page.

1. Local agent 2. Direct HTTP 3. OAuth connector
────────────── ────────────── ─────────────────
client client claude.ai / ChatGPT
│ stdio │ HTTPS │ HTTPS
mmw-agent (uvx) │ Authorization: │ client's own token
│ HTTPS, MMW_API_KEY │ Bearer mmw_… │ (sign-in on an MMW page)
▼ ▼ ▼
MMW server https://mcp.mmwhub.tech/mcp
MethodHow it worksWhat you get
Local agent mmw-agentThe client starts the agent with uvx; the agent forwards calls to the server. Requires Python 3.11+ and uv.Every server tool, the mmw_sync_status tool, and Claude Code and Codex session history upload (only with your consent). If the server is unreachable at start-up, the client does not fail.
Direct HTTPThe client config holds the server URL and an Authorization: Bearer mmw_… header.Every server tool. No session history and no mmw_sync_status. Nothing to install.
OAuth connectorThe web client opens an MMW page, you paste your API key, and the client receives its own token.Every server tool. Your key is not shared with the client.

The server tools are the same in every method: remember, search, forget, validate_memory, gateway_call, plus the tools of integrations connected to the key’s project.

ClientRecommended methodAlternativeSession history
Claude CodeLocal agentDirect HTTPYes, with consent
Claude DesktopLocal agent—No
claude.aiOAuth connector—No
ChatGPTOAuth connector in developer mode (beta)—No
CursorLocal agentDirect HTTPNo
CodexLocal agentDirect HTTP, if your Codex version supports remote serversYes, with consent
VS CodeDirect HTTP—No
Other MCP clientsDirect HTTPLocal agent, if the client runs stdio serversNo
Telegram botLinking in your account—Not applicable

Session history is uploaded only for Claude Code and Codex: the agent reads their session files on your computer. Search over uploaded sessions is not available yet.

All clients using the same key see the same memory. If a key is bound to a project, the client sees only that project. A handy setup is one key per computer: if a laptop is lost, you revoke one key and every other client keeps working. See API keys and OAuth.