# SolidInvoice — MCP server card for AI agents

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

Registry name: `co.solidinvoice/mcp` · category: Finance and crypto · version 3.1.3 · updated 2026-11-09

## Connect
- Remote (Claude Code): `claude mcp add --transport http solidinvoice https://solidinvoice.app/_mcp`

## Facts
- Repository: https://github.com/SolidInvoice/SolidInvoice (989 stars)
- Website: https://solidinvoice.co/docs/ai/mcp-server/

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/co-solidinvoice-mcp/


## SolidInvoice: invoices and quotes from your AI assistant

SolidInvoice is an open-source invoicing app for freelancers and small businesses, hosted or on your own server. This server lets your AI assistant read your invoices, quotes, clients and payments, and, if you allow it, create and update them. Each connection sees only the one company you picked when you approved it.

### Where to use it
- Ask what is still unpaid: Ask "which invoices are unpaid?" or "how much came in this month?" and get the answer from your real books.
- Turn an accepted quote into an invoice: When a client says yes to a quote, have your assistant copy it into a new invoice with the same items and totals.
- Chase overdue invoices: List what is overdue for a client and send each one a polite reminder email in one go.
- Log a cash or bank payment: Tell your assistant a client paid in cash or by transfer, and it records the payment and marks the invoice paid once it is settled.
- Monthly revenue report: Get revenue by day, week or month between two dates, plus totals still owed per currency, for your own monthly review.
- Retainers billed every month: Set up a recurring invoice for a client on a monthly retainer, and let your assistant check which ones are active. (idea, not from the official pages)

### How to start
- Add the server to your assistant. For a self-hosted SolidInvoice, use your own address ending in /_mcp.

```
claude mcp add --scope user --transport http solidinvoice https://solidinvoice.app/_mcp
```

- On the consent page, pick the company and tick write access only if the assistant should change things.

### License
SolidInvoice is MIT licensed, so you may self-host, change and use it in paid work. The hosted service at solidinvoice.co has its own plans, and the assistant connection needs a paid plan there.

### Good to know
- On the hosted service the assistant connection is for paid plans; a free trial is not enough. Self-hosted has no such limit.
- Reading is always on. Changing data is a separate box you tick on the consent page, so you can start read-only.
- The delete tool removes a client, contact or tax rate from the database right away. The reminder tool emails your real clients.
- There is no key-based login. An assistant that cannot do the browser sign-in cannot connect.
- A self-hosted SolidInvoice must be reachable over HTTPS for the sign-in to work.

Checked 2026-11-10 against: https://github.com/SolidInvoice/SolidInvoice/blob/2bbe031ddb5277f522e705e793420d883466fe73/docs/docs/ai/mcp-server.mdx, https://github.com/SolidInvoice/SolidInvoice/blob/2bbe031ddb5277f522e705e793420d883466fe73/src/McpBundle/README.md, https://github.com/SolidInvoice/SolidInvoice/blob/2bbe031ddb5277f522e705e793420d883466fe73/src/McpBundle/Action/Authorize.php, https://github.com/SolidInvoice/SolidInvoice/blob/2bbe031ddb5277f522e705e793420d883466fe73/src/McpBundle/Mcp/Tool/ResourceWriteTools.php, https://github.com/SolidInvoice/SolidInvoice/blob/2bbe031ddb5277f522e705e793420d883466fe73/src/InvoiceBundle/Mcp/InvoiceWriteTools.php, https://github.com/SolidInvoice/SolidInvoice/blob/2bbe031ddb5277f522e705e793420d883466fe73/src/McpBundle/Resources/agent/auth.md, https://github.com/SolidInvoice/SolidInvoice/blob/2bbe031ddb5277f522e705e793420d883466fe73/README.md, https://github.com/SolidInvoice/SolidInvoice/blob/2bbe031ddb5277f522e705e793420d883466fe73/LICENSE, https://solidinvoice.co/docs/ai/mcp-server/, https://solidinvoice.co/pricing/

### Mistakes to avoid
- Don't: Pass company or company_id in a write call to act on another company → Do: Connect once per company (for example solidinvoice-acme and solidinvoice-personal) and pick the matching connection (The server ignores the field and always uses the company chosen at consent.)
- Don't: delete_resource on an invoice or quote → Do: Use apply_invoice_transition or apply_quote_transition with cancel or archive; delete_resource only takes client, contact or tax (Invoices and quotes are not deletable through this tool.)
- Don't: Point a hosted assistant at a self-hosted instance on a private LAN address → Do: Expose the instance over HTTPS (or a tunnel) at the same hostname the agent is configured with (The OAuth flow uses browser redirects that a LAN address breaks.)
- Don't: Call send_invoice_reminder for every overdue invoice without asking → Do: List overdue invoices first, show them, and send reminders only for the ones the user picks (Each call emails the invoice's real contacts.)

### Questions
- Can the assistant see all my companies? No. Each connection is locked to one company chosen at sign-in; connect again under another name for a second company.
- How do I cut off an assistant? Revoke it under Profile, Connected apps. Its tokens stop working at once.
- Why do write tools say "insufficient scope"? Write access was not granted. Revoke the connection, reconnect, and tick write access on the consent page.
- Does it work with my own SolidInvoice server? Yes. The server is built in from version 3.0 and on by default; run the key and database commands once.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
