Skip to main content

Connect Claude Code to Atlas

note

This is for Claude Code (the CLI tool). For the desktop app, see Claude Desktop →.

Run this in your terminal from any project directory:

claude mcp add graphite-atlas \
  -e GRAPHITE_ACCESS_TOKEN=your-token-here \
  -e GRAPHITE_API_URL=https://graphiteatlas.com \
  -- npx -y @graphite-atlas/mcp-server

This adds Atlas to your Claude Code config permanently. Replace your-token-here with your actual token (get one here).

Option B: Project-level .mcp.json​

Add a .mcp.json file at your project root:

{
  "mcpServers": {
    "graphite-atlas": {
      "command": "npx",
      "args": ["-y", "@graphite-atlas/mcp-server"],
      "env": {
        "GRAPHITE_ACCESS_TOKEN": "your-token-here",
        "GRAPHITE_API_URL": "https://graphiteatlas.com"
      }
    }
  }
}

This scopes Atlas to that project only.

Verify​

Start a Claude Code session and type:

List my atlases

Claude should respond with the atlases in your Graphite Atlas account.

Troubleshooting​

Full troubleshooting guide →