InvoiceyDocs
Connect & automate

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 Workspace → 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 the workspace issuer

In Invoicey, add your business under My businesses, complete its identity, contact email and bank details, and choose the default issuer. Connected-workspace invoice tools read that seller server-side; they do not accept an issuer preset ID. A workspace without a usable issuer cannot create a draft. See issuer setup.

Ask the assistant to call get_workspace first so you can check the connected workspace and issuer.

Working with it

Cursor decides when to call tools, so plain description works:

Look up IČO 27074358 and prepare a draft using my workspace issuer for 25 hours of development at 1,500 CZK per hour, due in 21 days. Ask for missing dates, VAT and document language. Do not issue it yet.

Check the client, seller, amounts, dates and assumptions before confirming issuance.

For follow-ups:

Show me everything unpaid, oldest first.

Mark invoice 20260007 paid as of yesterday.

Troubleshooting