Claude

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 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 Connectors

In claude.ai or Claude Desktop, open Settings → Connectors (under Customize).

2) Add a custom connector

Click the + next to Connectors and choose Add custom connector.

3) 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/.)

4) Connect and sign in

The connector appears under Not connected. Click Connect and complete the xmemory sign-in (OAuth) when prompted.

5) Tools are ready

Once connected, xmemory’s read and write tools are available in your chats. You can fine-tune per-tool permissions from the connector’s page.

Custom connectors work on all plans, including Free — which allows one custom connector; paid plans (Pro / Max / Team / Enterprise) allow more.

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 https://mcp.xmemory.ai/instance/<instance_id>

The /instance/<instance_id> path binds the connection to that instance, and Claude Code completes an OAuth login on first use — no API key needed in 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.