Invoice Ninja MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.39.2更新于 Nov 14, 2026

Manage Invoice Ninja clients, invoices, quotes, expenses, tasks and projects.

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流金融商业与电商

概览

AI 生成的概览

托管的 Invoice Ninja 服务器,让助手读取和创建客户、发票、报价、费用、任务与项目,并可发送发票邮件。

可以做什么
  • 列出并获取客户,含联系人、余额与累计已付金额
  • 列出并获取发票和报价,可按客户与状态筛选,并查看周期性发票计划
  • 列出产品、付款、费用、供应商、任务与项目
  • 创建和更新客户与发票,创建草稿报价、费用、任务与项目
  • 将报价转为发票、把发票标记为已发送,或向客户发送发票邮件
  • 查看用量、提交功能请求、升级或取消订阅
适用场景
适合让助手回答账单问题,例如哪些发票逾期、每个客户欠多少,并在对话中起草发票、报价、费用和任务,无需离开聊天界面。
运行要求
远程 MCP 端点,无需本地安装。通过 OAuth 登录,登录页要求填写 Invoice Ninja API 令牌,自建实例还需填写实例地址。凭据由服务商按用户存储。免费方案每月 50 次工具调用,付费方案按用户计费。
安装前请注意
写入类工具会修改 Invoice Ninja 数据,email_invoice 会向客户联系人发送真实邮件且无法撤回。将发票标记为已发送会把金额计入客户余额。更新客户时传入 contacts 会替换联系人列表,更新发票时传入 line_items 会替换全部明细行。Invoice Ninja API 令牌会交给第三方托管方,升级工具会跳转到付费的 Stripe 结账页面。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Invoice Ninja MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Finvoice-ninja/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "invoice-ninja-by-usefulapi": {
      "type": "http",
      "url": "https://invoice-ninja.usefulapi.io/mcp"
    }
  }
}

README

Invoice Ninja MCP by usefulapi

Use Invoice Ninja from Claude, Cursor, or any MCP client — read and create clients, invoices, quotes, expenses, tasks and projects, convert quotes, and email invoices. Hosted, no local install: connect with your own Invoice Ninja credentials.

Live endpoint: https://invoice-ninja.usefulapi.io/mcp · Homepage: https://usefulapi.io/invoice-ninja

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://invoice-ninja.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http invoice-ninja https://invoice-ninja.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "invoice-ninja": {      "url": "https://invoice-ninja.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Invoice Ninja credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/invoice-ninja/

On first connect you'll provide your Invoice Ninja API token (Settings → Account Management → Integrations → API tokens), plus your instance URL if you self-host. They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
invoiceninja_list_clientsreadList clients
invoiceninja_get_clientreadGet one client
invoiceninja_list_invoicesreadList invoices
invoiceninja_get_invoicereadGet one invoice
invoiceninja_list_quotesreadList quotes
invoiceninja_get_quotereadGet one quote
invoiceninja_list_productsreadList products
invoiceninja_list_paymentsreadList payments
invoiceninja_list_expensesreadList expenses
invoiceninja_list_vendorsreadList vendors
invoiceninja_list_tasksreadList tasks
invoiceninja_list_projectsreadList projects
invoiceninja_list_recurring_invoicesreadList recurring invoices
invoiceninja_create_clientwriteCreate a client
invoiceninja_update_clientwriteUpdate a client
invoiceninja_create_invoicewriteCreate an invoice
invoiceninja_update_invoicewriteUpdate an invoice
invoiceninja_mark_invoice_sentwriteMark an invoice sent
invoiceninja_email_invoicewriteEmail an invoice to the client
invoiceninja_create_quotewriteCreate a quote
invoiceninja_convert_quote_to_invoicewriteConvert a quote to an invoice
invoiceninja_create_expensewriteCreate an expense
invoiceninja_create_taskwriteCreate a task / log time
invoiceninja_create_projectwriteCreate a project
invoiceninja_usage_statusmetaUsage status (free-tier meter)
invoiceninja_request_featuremetaRequest a missing feature
invoiceninja_upgrademetaUpgrade to Pro or Pro+
invoiceninja_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run invoiceninja_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with invoiceninja_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with invoiceninja_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Invoice Ninja.

来源:servers/invoice-ninja/README.md,提交 f22f848

工具

24

invoiceninja_list_clients

List clients

List clients with balances and contacts, optionally searched by name, email or number. Invoice Ninja: GET /api/v1/clients.

输入参数namepagesortemailfilternumberstatusbalanceper_page

invoiceninja_get_client

Get one client

Fetch one client by id, with contacts, address, balance and paid-to-date. Invoice Ninja: GET /api/v1/clients/{id}.

输入参数client_id必填

invoiceninja_list_invoices

List invoices

List invoices, filterable by client and payment status (paid / unpaid / overdue). status_id on each invoice: 1 draft, 2 sent, 3 partial, 4 paid, 5 cancelled, 6 reversed. Invoice Ninja: GET /api/v1/invoices.

输入参数pagesortfilternumberstatusper_pageclient_iddate_rangeclient_status

invoiceninja_get_invoice

Get one invoice

Fetch one invoice by id — line items, totals, balance, dates, status and invitations. Invoice Ninja: GET /api/v1/invoices/{id}.

输入参数invoice_id必填

invoiceninja_list_quotes

List quotes

List quotes (estimates), filterable by client and quote status. Invoice Ninja: GET /api/v1/quotes.

输入参数pagesortfilternumberstatusper_pageclient_idclient_status

invoiceninja_get_quote

Get one quote

Fetch one quote by id — line items, totals, status and the invoice it was converted to (invoice_id), if any. Invoice Ninja: GET /api/v1/quotes/{id}.

输入参数quote_id必填

invoiceninja_list_products

List products

List products / services in the catalog with price, cost and default taxes. Invoice Ninja: GET /api/v1/products.

输入参数pagesortfilterstatusper_pageproduct_key

invoiceninja_list_payments

List payments

List payments received, with amount, date, refunded/applied totals and the invoices each was applied to (paymentables). Read-only: this server never records or refunds payments. Invoice Ninja: GET /api/v1/payments.

输入参数pagesortfilternumberstatusper_pageclient_id

invoiceninja_list_expenses

List expenses

List expenses, filterable by client and invoicing/payment state. Invoice Ninja: GET /api/v1/expenses.

输入参数pagesortfilternumberstatusper_pageclient_idclient_status

invoiceninja_list_vendors

List vendors

List vendors (suppliers) with contacts and address. Invoice Ninja: GET /api/v1/vendors.

输入参数pagesortfilternumberstatusper_page

invoiceninja_list_tasks

List tasks

List tasks / time entries with their time_log, duration, rate and linked client, project and invoice. Invoice Ninja: GET /api/v1/tasks.

输入参数pagesortfilternumberstatusper_pageclient_idclient_status

invoiceninja_list_projects

List projects

List projects with client, budgeted hours, task rate, current hours and due date. Invoice Ninja: GET /api/v1/projects.

输入参数pagesortfilternumberstatusper_pageclient_id

invoiceninja_list_recurring_invoices

List recurring invoices

List recurring invoice schedules with frequency, next send date and remaining cycles. Read-only. Invoice Ninja: GET /api/v1/recurring_invoices.

输入参数pagesortnumberstatusper_pageclient_idclient_status

invoiceninja_create_client

Create a client

Create a client, optionally with contacts. Give at least a name or one contact. Invoice Ninja: POST /api/v1/clients.

输入参数citynamephonestatewebsiteaddress1address2contactsid_numbercountry_idvat_numberpostal_code另有 2 个

invoiceninja_update_client

Update a client

Update a client's details; only the fields you pass change. Passing contacts replaces the contact list. Invoice Ninja: PUT /api/v1/clients/{id}.

输入参数citynamephonestatewebsiteaddress1address2contactsclient_id必填id_numbercountry_idvat_number另有 3 个

invoiceninja_create_invoice

Create an invoice

Create a DRAFT invoice for a client. It is not sent or emailed — use invoiceninja_mark_invoice_sent or invoiceninja_email_invoice afterwards. Invoice Ninja: POST /api/v1/invoices.

输入参数datetermsfooternumberpartialdiscountdue_dateclient_id必填po_numbertax_name1tax_rate1line_items另有 5 个

invoiceninja_update_invoice

Update an invoice

Edit an invoice; only the fields you pass change, but line_items (if passed) replace every existing line. Does not send anything. Invoice Ninja: PUT /api/v1/invoices/{id}.

输入参数datetermsfooternumberpartialdiscountdue_datepo_numbertax_name1tax_rate1invoice_id必填line_items另有 5 个

invoiceninja_mark_invoice_sent

Mark an invoice sent

Mark a draft invoice as sent WITHOUT emailing it. This moves it out of draft and adds its amount to the client's balance. Invoice Ninja: GET /api/v1/invoices/{id}/mark_sent.

输入参数invoice_id必填

invoiceninja_email_invoice

Email an invoice to the client

OUTWARD-FACING: sends a real email with the invoice to the client's invited contacts, and marks the invoice sent. Cannot be unsent — confirm with the user first. Invoice Ninja: POST /api/v1/invoices/bulk with action=email.

输入参数email_typeinvoice_id必填

invoiceninja_create_quote

Create a quote

Create a DRAFT quote (estimate) for a client. Nothing is emailed. Invoice Ninja: POST /api/v1/quotes.

输入参数datetermsfooternumberpartialdiscountdue_dateclient_id必填po_numbertax_name1tax_rate1line_items另有 5 个

invoiceninja_convert_quote_to_invoice

Convert a quote to an invoice

Convert a quote into a new invoice (the quote is marked converted and links to it). Returns the new invoice. Invoice Ninja: GET /api/v1/quotes/{id}/convert_to_invoice.

输入参数quote_id必填

invoiceninja_create_expense

Create an expense

Log an expense, optionally tied to a vendor, client or project and flagged to be re-invoiced. Invoice Ninja: POST /api/v1/expenses.

输入参数dateamount必填client_idtax_name1tax_rate1vendor_idproject_idcategory_idcurrency_idpayment_datepublic_notesprivate_notes另有 2 个

invoiceninja_create_task

Create a task / log time

Create a task, optionally with logged time entries, for a client or project. Invoice Ninja: POST /api/v1/tasks.

输入参数ratedue_datetime_logclient_idproject_iddescription必填

invoiceninja_create_project

Create a project

Create a project for a client, with an optional hourly task rate, budget and due date. Invoice Ninja: POST /api/v1/projects.

输入参数name必填colordue_dateclient_id必填task_ratepublic_notesprivate_notesbudgeted_hours

版本历史

26
  1. v1.39.2最新Nov 14, 2026
  2. v1.39.1Nov 13, 2026
  3. v1.38.0Nov 12, 2026
  4. v1.37.3Nov 11, 2026
  5. v1.36.5Nov 8, 2026
  6. v1.36.4Nov 7, 2026
  7. v1.35.3Nov 5, 2026
  8. v1.35.2Nov 5, 2026
  9. v1.35.1Nov 4, 2026
  10. v1.35.0Nov 3, 2026
  11. v1.34.1Nov 3, 2026
  12. v1.33.0Nov 1, 2026
  13. v1.31.0Oct 31, 2026
  14. v1.30.0Oct 31, 2026
  15. v1.29.2Oct 30, 2026
  16. v1.29.0Oct 30, 2026
  17. v1.24.0Oct 26, 2026
  18. v1.21.3Oct 25, 2026
  19. v1.21.0Oct 25, 2026
  20. v1.20.0Oct 24, 2026
  21. v1.17.0Oct 23, 2026
  22. v1.16.4Oct 22, 2026
  23. v1.16.3Oct 21, 2026
  24. v1.11.1Oct 9, 2026
  25. v1.10.0Oct 9, 2026
  26. v1.0.0Sep 29, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成