Invoice Ninja MCP by usefulapi について
Claude、Cursor などの MCP クライアントから Invoice Ninja を管理する、ホスト型 MCP サーバーです。各種業務データの参照・作成、見積もりの請求書への変換、請求書メール送信に対応し、ローカルへのインストールは不要です。
主な機能
- 01顧客、請求書、見積もり、支払いの参照
- 02商品、経費、仕入先、定期請求書の管理
- 03顧客と請求書の作成・更新
- 04見積もりの作成と請求書への変換
- 05請求書のメール送信
- 06経費、タスク、プロジェクトの作成
活用シーン
- 01顧客の請求書と支払い履歴を確認
- 02見積もりを請求書に変換して送信
- 03経費を記録し、タスクやプロジェクトを作成
MCP 対応
ホスト型 MCP サーバーとして、Invoice Ninja の参照・書き込みツールを MCP クライアントに公開し、レコードの作成、更新、送信を支援します。OAuth でログインでき、セルフホスト型インスタンスの URL も指定できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://invoice-ninja.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-invoice-ninja https://invoice-ninja.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-invoice-ninja":{"type":"http","url":"https://invoice-ninja.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-invoice-ninja":{"type":"http","url":"https://invoice-ninja.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-invoice-ninja":{"type":"http","url":"https://invoice-ninja.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-invoice-ninja":{"serverUrl":"https://invoice-ninja.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
24| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| name | string | いいえ | 名前が一致するクライアントのみ。 |
| page | integer | いいえ | ページ番号。1 から始まります。 |
| sort | string | いいえ | 「column|asc」または「column|desc」の形式で並べ替えます。例:「number|desc」または「balance|desc」。 |
| string | いいえ | 連絡先のメールアドレスがこのメールアドレスであるクライアントのみ。 | |
| filter | string | いいえ | 名前、ID 番号、連絡先の名前/メールアドレス/電話番号、およびカスタムフィールドを全文検索します。 |
| number | string | いいえ | クライアント番号がこの番号であるクライアントのみ。 |
| status | string | いいえ | レコード状態をカンマ区切りで指定します:active、archived、deleted(例:「active」)。省略するとすべてが対象です。 |
| balance | string | いいえ | 残高の比較条件を「op:value」の形式で指定します。op は lt、lte、gt、gte、eq のいずれかです。例:「gt:0」。 |
| per_page | integer | いいえ | 1 ページあたりのレコード数。範囲は 1-100(API のデフォルトは 20)。 |
詳細
Invoice Ninja MCP by usefulapi
Claude、Cursor、または任意の MCP クライアントから Invoice Ninja を利用できます。クライアント、請求書、見積書、経費、タスク、プロジェクトの読み取りと作成、見積書の変換、請求書のメール送信が可能です。 ホスト型のため、ローカルへのインストールは不要です。ご自身の Invoice Ninja 認証情報で接続できます。
ライブエンドポイント: https://invoice-ninja.usefulapi.io/mcp · ホームページ: https://usefulapi.io/invoice-ninja
接続
- Claude(claude.ai、Desktop):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://invoice-ninja.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http invoice-ninja https://invoice-ninja.usefulapi.io/mcpを実行し、続いて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"invoice-ninja": {
"url": "https://invoice-ninja.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインし、ログインページで Invoice Ninja の認証情報を入力します。
手順を追ったセットアップ、認証情報の確認場所、FAQ:https://usefulapi.io/invoice-ninja/
初回接続時に、Invoice Ninja API トークン(Settings → Account Management → Integrations → API tokens)と、セルフホストの場合はインスタンス URL を入力します。 認証情報は検証され、ユーザーごとに保存され、本人にのみ適用されます。設定ファイルにキーを記載する必要はありません。
ツール
| ツール | 種類 | 機能 |
|---|---|---|
invoiceninja_list_clients | 読み取り | クライアント一覧を取得 |
invoiceninja_get_client | 読み取り | 1 件のクライアントを取得 |
invoiceninja_list_invoices | 読み取り | 請求書一覧を取得 |
invoiceninja_get_invoice | 読み取り | 1 件の請求書を取得 |
invoiceninja_list_quotes | 読み取り | 見積書一覧を取得 |
invoiceninja_get_quote | 読み取り | 1 件の見積書を取得 |
invoiceninja_list_products | 読み取り | 商品一覧を取得 |
invoiceninja_list_payments | 読み取り | 支払い一覧を取得 |
invoiceninja_list_expenses | 読み取り | 経費一覧を取得 |
invoiceninja_list_vendors | 読み取り | 仕入先一覧を取得 |
invoiceninja_list_tasks | 読み取り | タスク一覧を取得 |
invoiceninja_list_projects | 読み取り | プロジェクト一覧を取得 |
invoiceninja_list_recurring_invoices | 読み取り | 定期請求書一覧を取得 |
invoiceninja_create_client | 書き込み | クライアントを作成 |
invoiceninja_update_client | 書き込み | クライアントを更新 |
invoiceninja_create_invoice | 書き込み | 請求書を作成 |
invoiceninja_update_invoice | 書き込み | 請求書を更新 |
invoiceninja_mark_invoice_sent | 書き込み | 請求書を送信済みにする |
invoiceninja_email_invoice | 書き込み | 請求書をクライアントにメールで送信 |
invoiceninja_create_quote | 書き込み | 見積書を作成 |
invoiceninja_convert_quote_to_invoice | 書き込み | 見積書を請求書に変換 |
invoiceninja_create_expense | 書き込み | 経費を作成 |
invoiceninja_create_task | 書き込み | タスクを作成/作業時間を記録 |
invoiceninja_create_project | 書き込み | プロジェクトを作成 |
invoiceninja_usage_status | メタ | 使用状況(無料枠の使用量) |
invoiceninja_request_feature | メタ | 不足している機能をリクエスト |
invoiceninja_upgrade | メタ | Pro にアップグレード(無制限*) |
invoiceninja_cancel_subscription | メタ | Pro サブスクリプションをキャンセル |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアントが実行前に確認してください。meta ツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 価格 | 上限 |
|---|---|---|
| 無料 | $0 | 月あたり50回のツール呼び出し |
| Pro(ユーザーごと) | $9/mo または $90/yr(2か月無料) | 無制限* |
*Proには、このサーバーで月あたり10,000回のツール呼び出しという公正利用の上限があります。それ以上必要な場合は、[email protected] までお問い合わせください。
Proの対象はこのサーバーのみです。invoiceninja_upgrade で登録してください(Stripe Checkoutリンクが返されます)。invoiceninja_cancel_subscription でいつでも解約できます。Proは支払い済み期間の終了まで利用できます。現在の期間分の返金はありません。また、期間終了前に invoiceninja_upgrade を実行すると、解約が取り消されます。[email protected] へのお問い合わせも可能です。
ライセンス
MIT © usefulapi。Invoice Ninjaとは提携しておらず、同社からの承認も受けていません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。