Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.deepmerge.ai/llms.txt

Use this file to discover all available pages before exploring further.

Deepmerge works with any AI tool that speaks MCP. You connect it once per tool by pointing the tool at one address: 
https://app.deepmerge.ai/mcp
No API key. The first time a tool connects, a browser window opens and asks you to sign in to Deepmerge and approve access. That is the whole setup. You never paste a secret key into a config file. (This is different from tools like Exa that use an x-api-key header. Deepmerge uses a one-time sign-in instead.)

​
Pick your tool

No config files. Use the built-in connector:
  1. Open Claude and click +, then Add connectors (or go to Settings → Connectors).
  2. Choose Add custom connector.
  3. Paste https://app.deepmerge.ai/mcp and confirm.
  4. A Deepmerge sign-in window opens. Approve it.
Claude can now read and write your shared memory.
Run in your terminal:
claude mcp add --transport http deepmerge https://app.deepmerge.ai/mcp
The next time you use Claude Code, it opens a browser to sign in to Deepmerge.
Add to CursorOr add to ~/.cursor/mcp.json:
{
  "mcpServers": {
    "deepmerge": {
      "url": "https://app.deepmerge.ai/mcp"
    }
  }
}
Cursor opens a sign-in window the first time it connects.
Add to VS CodeOr add to .vscode/mcp.json in your project:
{
  "servers": {
    "deepmerge": {
      "type": "http",
      "url": "https://app.deepmerge.ai/mcp"
    }
  }
}
  1. Open the connectors / integrations settings.
  2. Add a new connector and paste https://app.deepmerge.ai/mcp.
  3. Sign in to Deepmerge when prompted and approve access.
Run in your terminal:
codex mcp add deepmerge --url https://app.deepmerge.ai/mcp
Add to ~/.codeium/windsurf/mcp_config.json:
{
  "mcpServers": {
    "deepmerge": {
      "serverUrl": "https://app.deepmerge.ai/mcp"
    }
  }
}
Add to your Zed settings:
{
  "context_servers": {
    "deepmerge": {
      "url": "https://app.deepmerge.ai/mcp"
    }
  }
}
Add to ~/.gemini/settings.json:
{
  "mcpServers": {
    "deepmerge": {
      "httpUrl": "https://app.deepmerge.ai/mcp"
    }
  }
}
Go to Settings → MCP Servers → Add MCP Server and add:
{
  "deepmerge": {
    "url": "https://app.deepmerge.ai/mcp"
  }
}
Add to your MCP config:
{
  "mcpServers": {
    "deepmerge": {
      "type": "streamable-http",
      "url": "https://app.deepmerge.ai/mcp"
    }
  }
}
For any client that supports remote MCP servers:
{
  "mcpServers": {
    "deepmerge": {
      "url": "https://app.deepmerge.ai/mcp"
    }
  }
}
If your client does not yet support remote sign-in, bridge it with mcp-remote, which handles the browser sign-in for you:
{
  "mcpServers": {
    "deepmerge": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.deepmerge.ai/mcp"]
    }
  }
}

​
What your tool can do once connected

A connected tool can read from and write to your shared memory. The full, always up-to-date list of actions lives in the reference.
GroupActions
Reading (never changes anything)look up context for a task, search and list saved notes, read one note, read edit history, see who is connected
Writing (saves or updates)save a note, update a note, archive a note, create a workspace
Read-only access and write access are separate permissions. If you grant a tool read-only access during sign-in, it can look things up but cannot change anything.

​
Troubleshooting

Some tools only start the sign-in the first time they actually use Deepmerge. Ask the tool to “list what’s in Deepmerge” to trigger it. If nothing happens, restart the tool fully so it picks up the new connector.
Restart your MCP client. Many clients only detect new servers on a full restart.
Your sign-in may have expired or been declined. Remove the Deepmerge connector and add it again to trigger a fresh sign-in.
Use the mcp-remote bridge shown under Any other MCP client above. It runs a small local helper that handles the browser sign-in and forwards everything to Deepmerge.
  • Cursor: ~/.cursor/mcp.json
  • VS Code: .vscode/mcp.json (in the project root)
  • Windsurf: ~/.codeium/windsurf/mcp_config.json
  • Gemini CLI: ~/.gemini/settings.json