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:
| Package | Purpose |
|---|---|
@modelcontextprotocol/sdk | MCP protocol implementation |
zod | Schema validation for tool parameters |
ulid | Monotone-ordered IDs for journal entries |
Next steps
Once installed, proceed to Configuration to connect the server to your Contox project.