MCP server

The Monnet MCP server exposes your workspace — motions, inbox, comments, approvals — to any client that speaks the Model Context Protocol. Read, draft, and act on motions from your coding agent.

Before you start

You need:

A Monnet account with at least one workspace.
A Monnet API key — generate one in Settings.
An MCP-compatible client: Claude Code, Claude Desktop, Cursor, or Codex.

Treat your API key like a password. Anyone with it can read and modify motions on your behalf. Revoke a key from Settings if it ever leaks.

Install

Claude Code
Claude Desktop
Cursor
Codex

Run:

claude mcp add monnet -e MONNET_API_KEY=<YOUR_KEY> -- npx -y @monnet/mcp

Restart Claude Code to pick up the new server.

Open your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the monnet entry under mcpServers:

{
  "mcpServers": {
    "monnet": {
      "command": "npx",
      "args": ["-y", "@monnet/mcp"],
      "env": {
        "MONNET_API_KEY": "<YOUR_KEY>"
      }
    }
  }
}

Restart Claude Desktop.

Open ~/.cursor/mcp.json (create it if needed) and add:

{
  "mcpServers": {
    "monnet": {
      "command": "npx",
      "args": ["-y", "@monnet/mcp"],
      "env": {
        "MONNET_API_KEY": "<YOUR_KEY>"
      }
    }
  }
}

Restart Cursor.

Run:

codex mcp add monnet --env MONNET_API_KEY=<YOUR_KEY> -- npx -y @monnet/mcp

Restart Codex.

Verify the connection

Ask your assistant:

Use the monnet_whoami tool to confirm the connection.

It returns your account details and the list of API keys attached to your account. If you get an authentication error, double-check the MONNET_API_KEY value in your config.

Environment variables

Variable	Required	Default	Purpose
`MONNET_API_KEY`	yes	—	Your Monnet API key. Sent on every request.
`MONNET_API_URL`	no	`https://api.monnet.ai`	Override the backend URL — useful for self-hosted or local setups.

Available tools

Tool	Purpose
`monnet_whoami`	Verify the connection and list the API keys on your account.

More tools — list_motions, get_motion, create_motion, comment, approve — are in development. This page updates as they ship.

Troubleshooting

The monnet tools don't appear in my client

Make sure you restarted the client after editing the config. In Claude Desktop, check Help → Logs for MCP-related errors.

I get a 401 / authentication error

The API key is missing, wrong, or revoked. Generate a fresh key in Settings and update your config.

npx hangs or fails to install

Check your Node.js version — the MCP server requires Node 20 or newer. Run node --version to confirm. If you use nvm or fnm, make sure the right version is active in the shell your MCP client inherits.

Getting started

Product

Integrations

Before you start

Install

Verify the connection

Environment variables

Available tools

Troubleshooting

Getting started

Product

Integrations

​Before you start

​Install

​Verify the connection

​Environment variables

​Available tools

​Troubleshooting

Before you start

Install

Verify the connection

Environment variables

Available tools

Troubleshooting