ChatGPT

Connect xmemory’s MCP server to ChatGPT and your chats get xmemory’s read and write tools with no custom code. This guide covers the custom connector in ChatGPT, plus the Codex 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.

ChatGPT custom connector

ChatGPT has no deep-link pre-fill, so you add the connector manually from Settings → Apps.

1) Open Apps settings

In ChatGPT, open Settings → Apps.

2) Enable Developer Mode

Open Advanced settings and enable Developer mode.

3) Create the connector

Click Create app, then give it a Name, choose OAuth authentication, and paste this MCP URL as the Server URL:

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

4) Approve and sign in

Approve the prompt and sign in with xmemory when prompted.

5) Connector ready

Once connected, mention the connector by name in a chat to use its tools. You can adjust its permissions from the app’s page.

A custom connector requires Plus / Pro / Business / Enterprise / Edu (not Free or Go). On Business / Enterprise / Edu, only workspace admins can add custom connectors.

Codex (CLI)

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

codex mcp add xmemory --url https://mcp.xmemory.ai/instance/<instance_id>

The /instance/<instance_id> path binds the connection to that instance and authorizes via OAuth on first use — no API key needed in the command. For headless use, configure a fixed Authorization: Bearer <xmemory API key> header for the server in your Codex config instead.

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>). The MCP server also offers two other connection types, chosen by the connect URL:

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

When creating the connector, paste the admin (or status) URL as the Server URL instead of the instance URL. For Codex:

codex mcp add xmemory-admin --url https://mcp.xmemory.ai/admin

See the MCP guide for the full admin tool list.