Skip to main content
Glama
syedahmad0786

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: Inv.bg-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.

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
    A
    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

  • Inv.bg-MCP

    unbelievable-digital
    F
    license
    Not graded
    quality
    B
    maintenance
    Provides read-only access to inv.bg invoicing data, enabling users to list clients and invoices and retrieve full document details and line items through natural language in Claude.
    1
    -

  • manager-mcp

    onexurOSS
    A
    license
    B
    quality
    A
    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
    77 PyPI
    AGPL 3.0

  • wfirma-mcp

    tajchert
    A
    license
    A
    quality
    B
    maintenance
    Enables read-only access to wFirma accounting data—invoices, expenses, contractors, and declarations—through natural language in MCP clients like Claude or Codex.
    9
    MIT