invbg-mcp

Remote MCP server (Claude connector) for the inv.bg invoicing API (APIv3). Runs on Cloudflare Workers with Streamable HTTP transport, so it can be added directly as a custom connector in Claude (claude.ai → Settings → Connectors) or as a remote MCP server in Claude Code / Claude Desktop.

Tools

All tools are read-only.

Related MCP server: InvoiceNinja MCP Server

Setup

npm install
cp .dev.vars.example .dev.vars   # then put your real inv.bg API token in it

.dev.vars and .env* are gitignored — secrets never go to git.

Local development

npm run dev                       # http://localhost:8787/mcp
npm run inspector                 # MCP Inspector to poke at the tools

Deploy

npx wrangler deploy
npx wrangler secret put INVBG_API_KEY   # paste your inv.bg token
# optional, recommended — protects the endpoint with a secret URL path:
npx wrangler secret put MCP_AUTH_KEY    # e.g. a long random string

Connect to Claude

The endpoint URL is:

• https://<worker>.workers.dev/mcp (no MCP_AUTH_KEY), or

• https://<worker>.workers.dev/mcp/<MCP_AUTH_KEY> (recommended)

claude.ai: Settings → Connectors → Add custom connector → paste the URL.

Claude Code:

claude mcp add --transport http invbg https://<worker>.workers.dev/mcp/<MCP_AUTH_KEY>

Configuration