PlugWiki
SolidInvoice logo

SolidInvoice MCP Server: Setup for Claude, Cursor and Other Apps

OfficialRemote
Gethttps://solidinvoice.app/_mcpsolidinvoice/solidinvoice

Lets Claude, Cursor and other assistants read your SolidInvoice invoices, quotes and clients, and create or update them if you allow it.

SolidInvoice has an MCP server built in, so your assistant can list invoices, check what is overdue, report revenue, and, with write access, create invoices and quotes or record payments. You connect to the cloud app or to your own instance by adding its address and signing in with your SolidInvoice account. Each connection is tied to one company, and you choose read-only or read and write when you approve it. There is no API-key option.

Good for

  • Freelancers and small businesses who invoice with SolidInvoice
  • Owners who want quick answers on overdue invoices and revenue
  • Self-hosters who want their own instance to work with AI agents

Works in

14 should work

Tap an app to see how to set it up and any known problems.

Install SolidInvoice MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the SolidInvoice MCP server to Claude Code. Run this command:
    
    claude mcp add --transport http solidinvoice https://solidinvoice.app/_mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Sign-in with the vendor account (OAuth).

Built from the package data we hold. Not yet tested by us.

Tools

  • Lists invoices, quotes, clients, contacts, payments or taxes

    Lists records of one type (invoice, quote, client, contact, payment, tax or recurring invoice) for your active company, with filters and paging. It is the general-purpose search tool.

    Try: “List my clients in the UK.”

    Network · list_resource

  • Fetches one record by its ID

    Returns the full detail of a single invoice, quote, client or other record when you know its ID.

    Try: “Show me invoice INV-0042 in full.”

    Network · get_resource

  • Lists invoices with a given status

    Returns invoices that are draft, pending, paid, overdue and so on, so you can review one stage of your billing.

    Try: “Show all draft invoices.”

    Network · list_invoices_by_status

  • Lists overdue invoices, for one client if you ask

    Finds invoices past their due date, optionally only for one client.

    Try: “Which invoices are overdue for Acme Ltd?”

    Network · list_overdue_invoices

  • Lists quotes with a given status

    Returns quotes in one stage, such as draft or accepted.

    Try: “List quotes that are still waiting for an answer.”

    Network · list_quotes_by_status

  • Lists recurring invoices, filtered by status or client

    Shows your scheduled repeating invoices, and can narrow them to a client or a status.

    Try: “Which recurring invoices do I have for Acme?”

    Network · list_recurring_invoices

  • Lists the payment methods set up for the company

    Returns the payment methods your active company has configured.

    Try: “What payment methods are set up?”

    Network · list_payment_methods

  • Lists the company's tax rates

    Returns the tax rates configured for your active company.

    Try: “List my tax rates.”

    Network · list_tax_rates

  • Shows which status changes a record allows right now

    For an invoice, quote or recurring invoice, lists the workflow steps (like send or cancel) you can apply next.

    Try: “What can I do next with quote Q-12?”

    Network · list_workflow_transitions

  • Shows the active company's ID, name and currency

    Returns basic facts about the company this connection is bound to, including its default currency.

    Try: “Which company am I connected to?”

    Network · get_company_info

  • Totals billed, paid and outstanding for one client

    Summarizes a client with the amount invoiced, outstanding balance, total paid and invoice counts.

    Try: “Summarize my billing with Acme Ltd.”

    Network · get_client_summary

  • Dashboard numbers: outstanding, overdue, counts

    Returns outstanding and overdue totals per currency, invoice counts by status and the client count, like the app dashboard.

    Try: “Give me my dashboard stats.”

    Network · get_dashboard_stats

Read from the source code

Permissions

medium risk · 6 things to watch

Medium risk

With write access the assistant can create and cancel invoices, record payments, email reminders to customers and delete clients. Approve read-only access unless you need changes, and revoke the connection when you finish.

What it can do

Watch out for

  • Write access can delete clients and tax data

    With the write scope, the assistant can delete clients, contacts and tax records and remove client tax IDs. Grant read only unless you need changes. github.com

  • It can email your customers

    With write access, the reminder tool sends a payment reminder email to an invoice's contacts. Check which invoice it names before approving. github.com

  • Invoices contain customer details

    Reading invoices and clients passes names, emails and amounts to your AI app. Connect only apps you trust with that data. github.com

  • It can change your billing records

    Write tools create and cancel invoices, record offline payments and change tax rates. Review invoices the assistant creates before you send them. github.com

  • Risk depends on the scope you grant

    Read scope alone is read-only. Write scope is opt-in at the sign-in screen and adds delete_resource and remove_client_tax_identifier, which is why the page rates the opt-in install as medium: the delete tools only cover clients, contacts, tax records and client tax IDs. github.com

  • You can revoke access at any time

    Open Profile, then Connected apps in SolidInvoice to see each agent and cut it off. Revoking invalidates its tokens straight away. github.com

Security advisories

No published security advisories for the MCP server as of Nov 1, 2026.

8 other advisories are about the wider SolidInvoice project, not this MCP server. See them on GitHub

Technical details
Turning on read-onlyOn the consent screen, leave the write scope unticked. The read scope is always on and write is opt-in.
Talks toYour SolidInvoice instance (cloud or self-hosted)
Sign-in and keysYou sign in through your browser with OAuth. The agent gets an access token valid for 24 hours and a refresh token valid for 90 days, both tied to one company.
Scopes
  • mcp:read

  • mcp:write

Questions

Is the SolidInvoice MCP server official?

Yes. It is built into SolidInvoice itself and ships in the same repository as the app.

What is the SolidInvoice MCP server URL?

For the cloud app it is https://solidinvoice.app/_mcp. For a self-hosted instance use your own host followed by /_mcp.

Does it work with a self-hosted SolidInvoice?

Yes. Use your instance address plus /_mcp. It must be reachable over HTTPS for sign-in to work, and you generate the OAuth signing keys once with the key command in the project docs.

Do I need an API key?

No. You sign in with your SolidInvoice account in the browser. The docs say there is deliberately no API-key option, so your client must support remote servers with OAuth.

Can it run read-only?

Yes. Read access is always on and write access is a separate choice on the sign-in screen. Leave write unticked and the change tools fail.

Can it delete my invoices or clients?

With write access it can delete clients, contacts and tax records. It can also cancel invoices through a status change. It has no tool that deletes an invoice outright.

Can it see more than one company?

No. Each connection is locked to the one company you pick when you approve it. To use another company, revoke the connection and reconnect.

Is it free?

SolidInvoice is open source under the MIT license and the MCP server is included. The cloud app's pricing is not covered in the project docs.

How do I add it to Claude?

Use the Claude Desktop custom connector or the Claude Code tab in the install box above, then approve access in your browser.

Information

updated Nov 2, 2026

Publisher
Official
Endpoint
https://solidinvoice.app/_mcp
Transport
Streamable HTTP
Auth
OAuth
Version
3.1.2
License
MIT
Last commit
Oct 31, 2026
Open issues
131
Listed in
Official MCP registry

WebsiteGitHubOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.