Claude MCP (Manual)

Connect xmemory’s MCP server to Claude and your agents get xmemory’s read and write tools with no custom code. This guide covers the custom connector for claude.ai and Claude Desktop (it also appears on the mobile apps once added), plus the Claude Code CLI.

See the integration overview for comprehensive guides, API references, and integration examples.

API key: To use xmemory APIs or integrations (including MCP), you need an API key. Get one from the xmemory console. Copy and securely store the key. Never share your API key publicly.

Claude (Desktop & claude.ai)

Add xmemory as a custom connector from claude.ai or Claude Desktop; once added, it shows up on the mobile apps too. The screenshots below are from Claude Desktop — claude.ai has the same layout.

The fastest way is the Add to Claude.ai button on your instance’s Connect page in the xmemory console — it deep-links straight to the Add custom connector dialog with the name and MCP URL pre-filled. To add it manually, follow the steps below.

1) Open Customize → Connectors and add a connector

Open Customize → Connectors — Connectors sits under the Customize heading of the settings screen, on claude.ai and Claude Desktop alike. Then open the Add menu beside the Connectors heading and choose Add custom connector.

2) Name it and paste the MCP URL

Give the connector a name and paste your xmemory MCP URL:

https://mcp.xmemory.ai/instance/<instance_id>

An instance URL binds the tools to that instance up front. (To pick the instance interactively during login instead, use the root URL https://mcp.xmemory.ai/.) The optional OAuth fields under Advanced settings stay empty. Click Add.

3) Connect and sign in

The connector’s page says it is not connected yet. Click Connect and complete the browser sign-in. That form is xmemory’s own and asks for one thing: an xmemory API key, which you create on the API Keys page of the console.

4) Tools are ready

Once connected, xmemory’s read and write tools are available in your chats. The connector’s page lists every tool by group — set a whole group (or any single tool) to Always allow, Needs approval, or Blocked; Custom mixes per-tool choices within a group.

Claude Code (CLI)

For the Claude Code CLI, add xmemory as an MCP server with the instance URL — the same command the Connect page generates:

claude mcp add --transport http xmemory-<FIRST8> https://mcp.xmemory.ai/instance/<instance_id>

Name the server xmemory- plus the first eight characters of the instance id — the same name xmemcli instance setup prints for it; the install guide explains why a shared name collides.

The /instance/<instance_id> path binds the connection to that instance, and Claude Code completes an OAuth login on first use — authorise it from inside a session with /mcp, or run claude mcp login xmemory-<FIRST8>. No API key goes into the command. For headless use (CI, scripts), pass a fixed API key instead by adding --header "Authorization: Bearer <xmemory API key>".

See the full MCP guide for both authentication paths, the complete tool list, and error handling.

Other connection types

The steps above bind to a single instance (/instance/<instance_id>) and expose its read/write tools. The MCP server offers two other connection types, chosen by the URL you connect with:

• Admin (fleet) tools — connect with https://mcp.xmemory.ai/admin to create instances, list clusters, and manage instance metadata. Admin is global-only (there is no /admin/<instance_id>).
• Status only — connect with https://mcp.xmemory.ai/status for the read-only service-status tool.

In a connector, paste the admin (or status) URL instead of the instance URL — or paste the root https://mcp.xmemory.ai/ and choose Admin MCP on the xmemory login page. For Claude Code, swap the URL in the claude mcp add command:

claude mcp add --transport http xmemory-admin https://mcp.xmemory.ai/admin

See the MCP guide for the full admin tool list.