Connect a Cloud Brain with MCP
Use the MindMux Cloud Brain MCP server to let an MCP-compatible client read and update the Cloud Brains available to your MindMux account.
The server uses OAuth. You sign in with your MindMux account in the browser during setup; do not create, copy, or paste an API key.
Before you start
- You need access to an active Plus or Team Workspace.
- The account you authorize can access only the Cloud Brains it is allowed to read or update in that Workspace.
- MindMux requests read and write access. Your client shows the authorization screen before it receives access.
Recommended: let your agent set it up
Open your project in Codex or Claude Code, then copy this message:
Please install the latest `@mindmux/cli` and use `mmx setup -agent` to configure it for this agent and project. Ask me when authorization or a choice is needed, then verify the connection.The CLI guides browser authorization and Workspace/Project selection, then configures the project's MCP connection and memory hooks. Restart the selected agent and approve its trust prompts after setup. Browser authorization and choices still require your participation.
Prefer the terminal? With Node.js 22 or later on macOS/Linux, run either npm install -g @mindmux/cli@latest or pnpm add -g @mindmux/cli@latest, then run mmx setup in your project. Use mmx doctor --online to check the connection.
Update the CLI
Already installed? Run this in a connected project:
mmx updateThis uses the owning npm or pnpm installer and refreshes managed Hook commands, MCP launchers and project instructions. Current releases also refresh other connected projects recorded by this CLI installation. Unrecorded projects need a refresh from their own directory. Login, Brain bindings and Brain content are kept; you do not need to run clean or repeat setup.
For an agent-driven upgrade, use mmx update --check --json, then mmx update --yes --json. Read mmx update --help and inspect warnings and per-project refresh results before reporting success.
If an older version has no update command, or you upgrade manually, use your original installer:
npm install -g @mindmux/cli@latestOr with pnpm: pnpm add -g @mindmux/cli@latest. Then refresh configuration:
mmx update --refresh-integrationsFor mise or source installations, upgrade through the original installation workflow, then run the same refresh command. Restart affected agents and approve changed hook trust prompts. Check mmx --version and run mmx doctor --online in the project. If the installed release does not refresh other projects automatically, run the refresh command in each connected project. Reported refresh failures need repair; a successful package upgrade alone does not prove hooks work.
The remaining sections describe direct MCP setup for other clients. Direct MCP setup provides tools; it does not install the CLI's project memory hooks.
Server address
Use this Remote Streamable HTTP MCP server address in your client:
https://mcp.mindmux.ai/mcpCodex
In a terminal, add the server and start the OAuth sign-in flow:
codex mcp add mindmux --url https://mcp.mindmux.ai/mcp
codex mcp login mindmuxYour browser opens the MindMux authorization page. Sign in, choose Authorize, then return to Codex. Confirm the server is available:
codex mcp listClaude Code
In the project where you use Claude Code, add the remote HTTP server:
claude mcp add --transport http mindmux https://mcp.mindmux.ai/mcpStart Claude Code, run /mcp, select mindmux, and follow the browser sign-in and authorization flow. Use claude mcp list to confirm that the server was added.
Cursor
Open Settings → Tools & MCP, add a new remote Streamable HTTP server, and use the server address above. Cursor then opens the MindMux OAuth flow when you connect the server.
If you configure Cursor through its mcp.json, use:
{
"mcpServers": {
"mindmux": {
"type": "http",
"url": "https://mcp.mindmux.ai/mcp"
}
}
}VS Code
Use the MCP server configuration in VS Code and add this entry to .vscode/mcp.json in the project you want to use:
{
"servers": {
"mindmux": {
"type": "http",
"url": "https://mcp.mindmux.ai/mcp"
}
}
}Open Copilot Chat in Agent mode, enable mindmux in the tools picker, and complete the OAuth flow when prompted.
Other MCP clients
If your client supports a remote HTTP or Streamable HTTP MCP server with OAuth, add the server address above and complete its sign-in prompt. If it provides an agent-assisted setup flow, you can send it this instruction:
Add the MindMux Cloud Brain MCP as an HTTP server named mindmux at https://mcp.mindmux.ai/mcp, then log in.Using your Cloud Brain
After authorization, ask your client to list the Workspaces or Cloud Brains available to you. MindMux will ask you to select a Cloud Brain when it needs one; it does not infer a Brain from a folder or repository name.
Use your MCP client's clear-authentication or remove-connection action to revoke a connection; the exact action depends on the client. After access is revoked, that client cannot read or change your Cloud Brains until you authorize it again.