Skip to main content
Glama
Sign In
BizDesk MCP

BizDesk MCP

by syedahmad0786
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

✅ Verified end-to-end on Windows with local Ollama (llama3.1, num_ctx=8192) — every command below is from a real run.

BizDesk MCP is a Model Context Protocol server that gives Claude (or any MCP client) structured, read-mostly access to a small-business back office: customers, invoices, and account notes. Ask Claude "who owes me money?" and it calls overdue_invoices() instead of guessing.

MCP is how AI assistants get real hands on real business data — and this repo is the pattern I use for client systems, shrunk to a clean, runnable example.

What it exposes

Kind

Name

What Claude can do with it

tool

list_customers(status)

enumerate active/churned accounts

tool

overdue_invoices(min_days_overdue)

fetch late invoices, most overdue first

tool

revenue_summary(year)

monthly paid revenue + top customer

tool

add_note(customer_name, note)

append a timestamped account note

resource

bizdesk://customers/{name}

full customer card (profile + invoices + notes)

Design choices worth copying: tools return structured rows, not prose; the only write path (add_note) is append-only; and the server ships instructions so the model knows the house rules before it calls anything.

Related MCP server: manager-mcp

Quickstart

pip install -r requirements.txt
python seed.py        # creates bizdesk.db (8 customers, ~50 invoices)

Claude Desktop — add to claude_desktop_config.json (see examples/):

{ "mcpServers": { "bizdesk": { "command": "python", "args": ["/abs/path/server.py"] } } }

Claude Code —

claude mcp add bizdesk -- python /abs/path/server.py

Restart the client, then try: "Which invoices are more than 30 days overdue, and draft a polite reminder for the worst one?" — watch it chain overdue_invoices → bizdesk://customers/... → a grounded draft.

Point it at real data

bizdesk.db is plain SQLite. Swap the queries in server.py for your Postgres/Airtable/QuickBooks layer and the MCP surface stays identical — the client never knows the backend changed. That's the point of the protocol.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Kledo MCP

      kevzakaria
      A
      license
      Not graded
      quality
      B
      maintenance
      Provides read-only access to Kledo accounting data, enabling listing and searching of invoices, contacts, products, and running financial reports through natural language.
      20 npm
      Apache 2.0

    • manager-mcp

      onexurOSS
      A
      license
      B
      quality
      B
      maintenance
      Enables AI assistants to query and manage self-hosted accounting data—invoices, balances, and books—through natural language, with read-only tools by default and optional scoped write operations.
      30
      24 PyPI
      1
      AGPL 3.0

    • bookings-mcp

      satviksriv
      A
      license
      A
      quality
      C
      maintenance
      Enables Claude to manage a service business front desk by searching customers, checking real-time availability, creating and canceling appointments without double-booking, and generating revenue reports from actual data.
      9
      MIT

    • mcp-xero

      pipeworx-io
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to query a connected accounting platform for organisations, invoices, contacts, chart of accounts, and profit-and-loss reports, supporting bookkeeping, AR/AP, and financial reporting workflows.
      299 npm
      MIT