acumulus-mcp

acumulus-mcp

MCP server for Acumulus — let an AI assistant (Claude Desktop, Claude Code, Cursor, …) read and modify your Acumulus administration through natural language, over the official Acumulus API.

Runs locally over stdio. Your Acumulus credentials stay on your machine; there is no telemetry and no proxy.

Install

pip install acumulus-mcp

Requires Python 3.10+.

Configure credentials

The server authenticates with your Acumulus contract code, username and an API token (generate one in Acumulus under your profile; it travels in the API's <password> field). Provide them as environment variables:

export ACUMULUS_CONTRACT_CODE=123456
export ACUMULUS_USERNAME=your-username
export ACUMULUS_API_TOKEN=your-api-token
# optional: validate writes without persisting them
export ACUMULUS_TESTMODE=1

Register in your MCP client

Claude Code:

claude mcp add acumulus \
  -e ACUMULUS_CONTRACT_CODE=123456 \
  -e ACUMULUS_USERNAME=your-username \
  -e ACUMULUS_API_TOKEN=your-api-token \
  -- acumulus-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "acumulus": {
      "command": "acumulus-mcp",
      "env": {
        "ACUMULUS_CONTRACT_CODE": "123456",
        "ACUMULUS_USERNAME": "your-username",
        "ACUMULUS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Restart your client, then try: "Use the acumulus whoami tool to test the connection."

Tools

The acumulus_request tool means every Acumulus function is reachable even before it gets a dedicated wrapper — the credential/envelope is added for you; you only pass the endpoint path and the function-specific fields.

Safety

Set ACUMULUS_TESTMODE=1 to have Acumulus validate write calls without persisting them — do a dry run before pointing it at the live administration.

License

AGPL-3.0-or-later. For a commercial license, contact nick@easeo.nl.