@monnet/mcp

Model Context Protocol (MCP) server for Monnet.

Exposes motions, plans, and approvals to MCP-compatible clients (Claude Desktop, Cursor, etc.) so you can work with your Monnet workspace from your terminal without leaving your AI assistant.

Install

Add this to your MCP client config (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json for Claude Desktop):

{
  "mcpServers": {
    "monnet": {
      "command": "npx",
      "args": ["-y", "@monnet/mcp"],
      "env": {
        "MONNET_API_KEY": "mnk_..."
      }
    }
  }
}

Generate an API key at https://app.monnet.ai/settings (API Keys tab).

Environment variables

| Variable | Required | Default | Purpose | |---|---|---|---| | MONNET_API_KEY | yes | — | API key (mnk_*), sent as the X-API-Key header on every request | | MONNET_API_URL | no | https://api.monnet.ai | Override for self-hosted or local dev backends |

Tools

| Tool | Purpose | |---|---| | monnet_whoami | Verify the connection and list the API keys on your account | | list_workspaces | List the workspaces you belong to | | get_inbox | Fetch your inbox | | list_motions | List motions in a workspace | | get_motion | Read a motion — summary, body, plan, members, comments | | create_motion | Create a new draft motion from a free-form prompt | | update_motion | Update a motion's summary, body, priority, or plan | | comment | Post a comment on a motion (approval-gated, see below) | | approve | Approve a plan step | | reject | Reject a plan step (with an optional reason) | | ask_monnet | Ask Monnet a question on a motion |

Approval gate on send actions

Tools that send a message under your identity (e.g. comment) never dispatch automatically. Before the message leaves the MCP server, your client shows a confirmation dialog (MCP elicitation) with a preview; nothing is sent unless you explicitly approve. If your MCP client does not support elicitation, the send is aborted — the gate fails closed.

Local development

npm install
npm run build

Point your MCP client at the local build:

{
  "mcpServers": {
    "monnet": {
      "command": "node",
      "args": ["/absolute/path/to/monnet-mcp/dist/index.js"],
      "env": {
        "MONNET_API_KEY": "mnk_...",
        "MONNET_API_URL": "http://localhost:8000"
      }
    }
  }
}

Restart your MCP client after editing the config.

License

MIT