Axiomry LogoAxiomry
Documentation
Back to MCP Integration

Codex Integration

Connect OpenAI Codex 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 Codex in a few simple steps.

1. Create Access Token

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

2. Configure Codex

Add the config to your TOML file and export your token as an environment variable, following the instructions below

MCP Configuration

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

Config file location

macOS / Linux: ~/.codex/config.toml or .codex/config.toml (project-scoped)

Windows: ~/.codex/config.toml or .codex/config.toml (project-scoped)

Quick install (CLI)

codex mcp add axiomry --url https://axiomry.com/api/mcp --bearer-token-env-var AXIOMRY_MCP_TOKEN
[mcp_servers.axiomry]
bearer_token_env_var = "AXIOMRY_MCP_TOKEN"
enabled = true
url = "https://axiomry.com/api/mcp"

Set your token

The config above does not contain your token — Codex reads it from the AXIOMRY_MCP_TOKEN environment variable. Export it before launching Codex:

export AXIOMRY_MCP_TOKEN=YOUR_API_KEY_HERE

Installation Steps

  1. First export your token: Codex reads it from an environment variable, not from any file. Add `export AXIOMRY_MCP_TOKEN=mk_your_token_here` to your shell profile (~/.zshrc or ~/.bashrc) and open a new terminal.
  2. Fastest: run the CLI command above (`codex mcp add …`) to register the server.
  3. Or manually: add the config below to ~/.codex/config.toml (global) or .codex/config.toml in your project root.
  4. Restart Codex, then test with: "What MCP tools are available?"

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

Example AI Conversations

Try these natural language commands with Codex 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 →