Documentation

Claude Code Integration

Connect Claude Code to Axiomry using Model Context Protocol for seamless AI-powered task management

Security Notice

Only connect to your development/staging Axiomry instances. Never use production access tokens with AI tools. Always review AI-generated changes before applying.

Quick Start

Get up and running with Axiomry MCP integration in Claude Code in 3 simple steps.

1. Create Access Token

Go to Settings → MCP Server Access in your Axiomry dashboard and create a new access token

2. Configure Your Code Editor

Follow the configuration instructions below to set up MCP in Claude Code

MCP Configuration

Add the following to your Claude Code MCP config file, then replace YOUR_API_KEY_HERE with your access token. Create Access Token.

Config file location

macOS / Linux: ~/.claude.json (user scope) or .mcp.json in your project root (project scope)

Windows: ~/.claude.json (user scope) or .mcp.json in your project root (project scope)

Quick install (CLI)

claude mcp add --transport http axiomry https://axiomry.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY_HERE"

{
  "mcpServers": {
    "axiomry": {
      "type": "http",
      "url": "https://axiomry.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Installation Steps

Fastest: run the CLI command above. It registers the server for the current project (add `-s user` to make it available across all your projects).
Manual, project-shared: create a `.mcp.json` file in your project root and paste the config below (commit it to share with your team).
Manual, user-wide: run `claude mcp add-json` or edit `~/.claude.json` — Claude Code does not read a `~/.claude/mcp.json` file.
Replace `YOUR_API_KEY_HERE` in the Authorization header with your Axiomry access token.
Restart Claude Code, then test with: "What MCP tools are available?"

Save the file and restart Claude Code. The Axiomry tools will then be available to your AI assistant.

Example AI Conversations

Try these natural language commands with Claude Code to manage your Axiomry tasks.

Task Management

"What projects do I have in Axiomry?"

Shows all your projects with current status

"Show me available tasks I can work on project X"

Lists unblocked tasks ready to begin for a specific project

"Create a new task for implementing feature X"

Creates a new task in your project

Project Operations

"Mark the database migration task as complete"

Updates task status and unblocks dependent tasks

"What's the current status of my project?"

Shows project overview with task completion status

"Show me tasks that are blocked by others"

Lists tasks waiting for dependencies to complete

Next Steps

Explore Available Tools

Discover all the MCP tools available in Axiomry and learn how to use them effectively.

View Supported Tools →