Connect Claude to Atlas

This gets Claude talking to your Atlas in about 5 minutes.

Prerequisites

1. Node.js installed (check with node --version in your terminal)
2. Claude Desktop installed
3. An Atlas API key (how to generate one)

Step 1: Open the config file

Mac: Open Terminal and run:

open ~/Library/Application\ Support/Claude/

Windows: Press Win + R, type %APPDATA%\Claude and hit Enter.

Look for a file called claude_desktop_config.json. If it doesn't exist, create it.

Step 2: Paste the config

If the file is empty or new, paste this (replace your-token-here with your actual API key):

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

If you already have other MCP servers configured, add the "graphite-atlas" block inside your existing "mcpServers" object. Don't replace the whole file.

Copy Config button

When you generate your API key in Atlas, there's a Copy Config button that copies this JSON with your token already filled in. Use that to avoid typos.

Step 3: Restart Claude

Fully quit Claude (right-click the dock/taskbar icon and choose Quit, don't just close the window). Then reopen it.

Step 4: Verify it works

In a new Claude conversation, type:

List my atlases

Claude should call a tool called list_atlases and show your Atlas data. If you see your atlases, you're connected.

Things to try

• "What's in my atlas?"
• "Show me all the processes"
• "Who is responsible for the monthly close?"
• "Create a new atlas called Test and add three people to it"

Claude Code (CLI)

For Claude Code, add the same config to your project's .claude/settings.json or ~/.claude/settings.json:

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

Troubleshooting

Tools not appearing (no hammer icon):

• Make sure you fully quit and reopened Claude, not just closed the window
• Check that claude_desktop_config.json has valid JSON (no trailing commas, matching brackets)
• Verify Node.js is installed: node --version

"Unauthorized" / 401: Your token expired or was revoked. Generate a new one in Atlas Settings.

"GRAPHITE_ACCESS_TOKEN required": The config didn't paste correctly. Check the env variables in your config file.

Still stuck? Email [email protected]