Skip to content

Install the package

Install @contox/mcp-server globally using npm:

bash
npm install -g @contox/mcp-server

This installs the contox-mcp binary globally, making it available as a command.

Verify the installation

After installing, confirm the binary is accessible:

bash
contox-mcp --help

You can also verify the install location:

bash
which contox-mcp    # macOS/Linux
where contox-mcp    # Windows

Alternative: use npx

If you prefer not to install globally, you can reference the package directly in your Claude Desktop configuration using npx:

json
{
  "mcpServers": {
    "contox": {
      "command": "npx",
      "args": ["-y", "@contox/mcp-server"],
      "env": {
        "CONTOX_API_KEY": "<your-key>",
        "CONTOX_PROJECT_ID": "<project-id>",
        "CONTOX_TEAM_ID": "<team-id>"
      }
    }
  }
}

Requirements

  • Node.js: 18 or later
  • npm: 9 or later
  • A Contox account with an API key (generate one from the Contox dashboard)

Dependencies

The MCP server has minimal dependencies:

PackagePurpose
@modelcontextprotocol/sdkMCP protocol implementation
zodSchema validation for tool parameters
ulidMonotone-ordered IDs for journal entries

Next steps

Once installed, proceed to Configuration to connect the server to your Contox project.