Claude Code

Connect Claude

Let Claude find the memories that matter to your work, and save the details you want to keep.

Before you start

This guide covers Claude Code. Install Claude Code and get an access token from your own registered Maury OAuth connection. Start with memories:read. The authentication guide explains what your connection needs.

Set your local token

Make MAURY_MCP_ACCESS_TOKEN available in the environment where you launch Claude Code. Its value should be your own Maury OAuth access token.

Add the remote server

Run the command below. Keep the single quotes so your shell leaves the environment-variable reference in the configuration; Claude expands it when it starts.

Terminal

claude mcp add-json --scope user maury '{
  "type": "http",
  "url": "https://app.maury.ai/mcp",
  "headers": {
    "Authorization": "Bearer ${MAURY_MCP_ACCESS_TOKEN}"
  }
}'

The user scope makes this connection available across your projects. It is Claude’s configuration scope, separate from your Maury OAuth permissions.

Ask Claude to find a memory

Restart Claude Code from the environment containing your token. Open /mcp and check the Maury connection, then ask:

Find my notes in Maury about the project we’re working on.

Claude can search and read memories you have permission to access.

Give Claude permission to remember

To save text, your OAuth connection needs memories:write in addition to memories:read. Complete a new consent flow with both scopes, update the token in your environment, and restart Claude Code.

Remember in Maury that I prefer a short written summary before planning meetings.

Correct a saved detail

To update existing memories, authorize memories:read and memories:edit, provide the new token, and restart Claude Code. Recording permission alone cannot edit.

Correct my Maury memory about the project review: it is on Friday. Update the original memory and preserve the other details.

The agent fetches the full text and revision, then replaces the text using update_memory. If another edit intervened, it must fetch again and review the correction. See how corrections work.

Official Claude Code MCP reference