manager-mcp

Read-only MCP server for self-hosted Manager.io bookkeeping. Curated GET tools only — no create/update/delete.

Requirements

• Python >= 3.10

• Reachable Manager.io API (MANAGER_API_URL + MANAGER_API_KEY)

Related MCP server: SimpleShop MCP

Run (stdio MCP — no global install)

This is a Python package. The npx equivalent is uvx (ships with uv). Transport is stdio by default (manager-mcp → mcp.run()).

Zero-install from this repo (uvx --from)

uvx --from E:/Development/manager-mcp manager-mcp

Cursor / Claude Desktop / any MCP host — paste into MCP config:

{
  "mcpServers": {
    "manager": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "E:/Development/manager-mcp", "manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

Optional writes: add "MANAGER_MCP_ALLOW_WRITES": "1" under env.

Local editable (dev)

uv sync --extra dev
uv run manager-mcp

{
  "mcpServers": {
    "manager": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "E:/Development/manager-mcp", "manager-mcp"],
      "env": {
        "MANAGER_API_URL": "http://127.0.0.1:55667/api2",
        "MANAGER_API_KEY": "your-token"
      }
    }
  }
}

After publishing to PyPI

uvx manager-mcp

"args": ["manager-mcp"]

npx only runs npm packages — skip unless you add a Node wrapper later.

Environment

Truthy values (case-insensitive): 1, true, yes, on. Anything else (or unset) keeps the server read-only.

Tools

Bank dual path (intentional): bank_balances answers “what are my balances?”; list_records/get_record on bank_accounts answers “find account X and show detail.”

Collections: customers, suppliers, sales_invoices, purchase_invoices, chart_of_accounts, bank_accounts.

Agent Skill

Companion skill: skills/manager-accounting/SKILL.md.

Tests / CI

Offline only (respx). No live Manager required:

uv run ruff check src tests
uv run pytest

GitHub Actions matrix: Python 3.10 and 3.12.

Caveats

• One process ↔ one MANAGER_API_URL. Multi-instance routing is out of scope.

• Multi-business disambiguation on a shared host is unverified — do not claim multi-business support until validated against a live multi-business setup.

• Vendored src/manager_mcp/spec/api2.json is provenance only; runtime always hits the live URL.

License

MIT — see LICENSE.