Connect Claude Code to Gravitask

1. Create an API key

In the Gravitask app, open Settings > API & MCP and generate a key (create a free account first if you need one; API access needs Pro or higher). Grant the least access that does the job: pick the Read only scope for analysis and reporting, or restrict the key to tool groups such as Time tracking. The decision guide explains the options. Copy the key now; it is shown once.

2. Add the server to Claude Code

There are two ways in, and they end at the same configuration. Pick whichever matches how you use Claude Code.

export GRAVITASK_API_KEY="YOUR_API_KEY"
claude mcp remove gravitask -s local 2>/dev/null || true
claude mcp add-json gravitask '{"type":"http","url":"https://app.gravitask.com/mcp","headers":{"Authorization":"Bearer ${GRAVITASK_API_KEY}"}}'

{
  "mcpServers": {
    "gravitask": {
      "type": "http",
      "url": "https://app.gravitask.com/mcp",
      "headers": {
        "Authorization": "Bearer ${GRAVITASK_API_KEY}"
      }
    }
  }
}

3. Check it works

• Run claude mcp get gravitask and check the server shows type http with your Authorization header.
• Start a session and run /mcp. Gravitask should be listed as connected with its tools available.
• In the desktop app or an IDE extension, type /mcp in the prompt: the same gravitask entry should show as connected, because every Claude Code surface shares one configuration.
• Ask: "List my Gravitask projects." You should see your workspace projects, not an authentication prompt.

Prompts to try

Troubleshooting