@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

Tools

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