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 →.

The Graphite Atlas plugin gives Claude Code the Atlas tools and the modeling skills in one install. In Claude Code:

/plugin marketplace add graphiteatlas/atlas-skills
/plugin install graphite-atlas

Then run /mcp, choose graphite-atlas and sign in to Atlas in the browser. No API key or Node.js needed. See Atlas skills and plugin.

Option B: Tools only, with sign-in​

Run this in your terminal:

claude mcp add --transport http graphite-atlas https://graphiteatlas.com/api/mcp

Then run /mcp in Claude Code, choose graphite-atlas and sign in.

Option C: API key​

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 -p @graphite-atlas/mcp-server graphite-mcp

Replace your-token-here with your token (get one here). This needs Node.js.

To scope Atlas to one project instead, add a .mcp.json file at the project root:

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

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 →