Cursor
Connect Cursor to Invoicey’s hosted MCP tools.
Cursor speaks MCP natively, so Invoicey's tools appear alongside its own once configured.
Configuration
MCP servers are configured in mcp.json — ~/.cursor/mcp.json for every project, or
.cursor/mcp.json inside one project.
{
"mcpServers": {
"invoicey": {
"url": "https://invoicey.app/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Create the key under Settings → API keys — see API keys.
Do not commit this file
A project-level .cursor/mcp.json containing a bearer token is a credential
in your repository. Add it to .gitignore, or configure Invoicey globally in
~/.cursor/mcp.json instead.
Then Settings → MCP → Reload, and confirm Invoicey is listed with its tools.
Set up a preset first
Before your first invoice, save an issuer preset. Ask Cursor:
Save an issuer preset called "main" using these details: …
The preset locks the "from" party. Without one, create_invoice falls back to a demo issuer — which
renders fine and is completely wrong for real use.
Working with it
Cursor decides when to call tools, so plain description works:
Look up IČO 27074358 and create an invoice from my "main" preset for 25 hours of development at 1 500 CZK, due in 21 days.
Naming the preset explicitly avoids a round-trip where the assistant lists presets to find one.
For follow-ups:
Show me everything unpaid, oldest first.
Mark invoice 20260007 paid as of yesterday.