KosmoKrator

productivity

Invoice Ninja MCP Gateway for AI Agents

Expose Invoice Ninja tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

Invoice Ninja MCP Gateway

Expose Invoice Ninja to MCP clients with `kosmokrator mcp:serve --integration=invoiceninja`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server.

Install KosmoKrator 
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
Install gateway entry 
kosmokrator mcp:gateway:install --integration=invoiceninja --write=deny --json
MCP configuration 
{
  "mcpServers": {
    "kosmokrator-invoiceninja": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=invoiceninja",
        "--write=deny"
      ]
    }
  }
}
Serve manually 
kosmokrator mcp:serve --integration=invoiceninja --write=deny

Client Notes

Use one scoped MCP gateway entry, then adapt the config location to the client or framework.

Claude Code Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry. Claude Code can launch the local kosmo binary directly from the project MCP config.
Cursor Expose selected local integrations to Cursor through KosmoKrator without configuring each service as its own MCP server. Use the same KosmoKrator install and integration credentials that power terminal and headless runs.
Codex Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy. Keep write access denied or ask-based unless the workspace is trusted.
OpenAI Agents SDK Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway. Use headless JSON commands for CI-style execution and MCP for agent tool discovery.
Claude Agent SDK Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server. Use a narrow integration list so the agent does not load unrelated tools.
Vercel AI SDK Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts. Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.
LangChain Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls. Keep the gateway scoped to the integration and operation class needed by the chain.
LangGraph Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions. Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.
CrewAI Expose KosmoKrator integrations to CrewAI workers as scoped local tools. Use per-worker integration scopes to avoid giving every worker every tool.
Generic MCP Clients Connect any stdio-compatible MCP client to local KosmoKrator integration tools. Start with read-only write policy and expand only for trusted projects.

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names.

MCP toolSource functionType
integration__invoiceninja__invoiceninja_blank_client invoiceninja.invoiceninja_blank_client Read read
integration__invoiceninja__invoiceninja_blank_credit invoiceninja.invoiceninja_blank_credit Read read
integration__invoiceninja__invoiceninja_blank_expense invoiceninja.invoiceninja_blank_expense Read read
integration__invoiceninja__invoiceninja_blank_invoice invoiceninja.invoiceninja_blank_invoice Read read
integration__invoiceninja__invoiceninja_blank_payment invoiceninja.invoiceninja_blank_payment Read read
integration__invoiceninja__invoiceninja_blank_product invoiceninja.invoiceninja_blank_product Read read
integration__invoiceninja__invoiceninja_blank_project invoiceninja.invoiceninja_blank_project Read read
integration__invoiceninja__invoiceninja_blank_purchase_order invoiceninja.invoiceninja_blank_purchase_order Read read
integration__invoiceninja__invoiceninja_blank_quote invoiceninja.invoiceninja_blank_quote Read read
integration__invoiceninja__invoiceninja_blank_recurring_invoice invoiceninja.invoiceninja_blank_recurring_invoice Read read
integration__invoiceninja__invoiceninja_blank_task invoiceninja.invoiceninja_blank_task Read read
integration__invoiceninja__invoiceninja_blank_tax_rate invoiceninja.invoiceninja_blank_tax_rate Read read
integration__invoiceninja__invoiceninja_blank_vendor invoiceninja.invoiceninja_blank_vendor Read read
integration__invoiceninja__invoiceninja_bulk_clients invoiceninja.invoiceninja_bulk_clients Write write
integration__invoiceninja__invoiceninja_bulk_credits invoiceninja.invoiceninja_bulk_credits Write write
integration__invoiceninja__invoiceninja_bulk_expenses invoiceninja.invoiceninja_bulk_expenses Write write
integration__invoiceninja__invoiceninja_bulk_invoices invoiceninja.invoiceninja_bulk_invoices Write write
integration__invoiceninja__invoiceninja_bulk_payments invoiceninja.invoiceninja_bulk_payments Write write
integration__invoiceninja__invoiceninja_bulk_products invoiceninja.invoiceninja_bulk_products Write write
integration__invoiceninja__invoiceninja_bulk_projects invoiceninja.invoiceninja_bulk_projects Write write
integration__invoiceninja__invoiceninja_bulk_purchase_orders invoiceninja.invoiceninja_bulk_purchase_orders Write write
integration__invoiceninja__invoiceninja_bulk_quotes invoiceninja.invoiceninja_bulk_quotes Write write
integration__invoiceninja__invoiceninja_bulk_recurring_invoices invoiceninja.invoiceninja_bulk_recurring_invoices Write write
integration__invoiceninja__invoiceninja_bulk_tasks invoiceninja.invoiceninja_bulk_tasks Write write
integration__invoiceninja__invoiceninja_bulk_tax_rates invoiceninja.invoiceninja_bulk_tax_rates Write write
integration__invoiceninja__invoiceninja_bulk_vendors invoiceninja.invoiceninja_bulk_vendors Write write
integration__invoiceninja__invoiceninja_create_client invoiceninja.invoiceninja_create_client Write write
integration__invoiceninja__invoiceninja_create_credit invoiceninja.invoiceninja_create_credit Write write
integration__invoiceninja__invoiceninja_create_expense invoiceninja.invoiceninja_create_expense Write write
integration__invoiceninja__invoiceninja_create_invoice invoiceninja.invoiceninja_create_invoice Write write
integration__invoiceninja__invoiceninja_create_payment invoiceninja.invoiceninja_create_payment Write write
integration__invoiceninja__invoiceninja_create_product invoiceninja.invoiceninja_create_product Write write
integration__invoiceninja__invoiceninja_create_project invoiceninja.invoiceninja_create_project Write write
integration__invoiceninja__invoiceninja_create_purchase_order invoiceninja.invoiceninja_create_purchase_order Write write
integration__invoiceninja__invoiceninja_create_quote invoiceninja.invoiceninja_create_quote Write write
integration__invoiceninja__invoiceninja_create_recurring_invoice invoiceninja.invoiceninja_create_recurring_invoice Write write
integration__invoiceninja__invoiceninja_create_task invoiceninja.invoiceninja_create_task Write write
integration__invoiceninja__invoiceninja_create_tax_rate invoiceninja.invoiceninja_create_tax_rate Write write
integration__invoiceninja__invoiceninja_create_vendor invoiceninja.invoiceninja_create_vendor Write write
integration__invoiceninja__invoiceninja_delete_client invoiceninja.invoiceninja_delete_client Write write
integration__invoiceninja__invoiceninja_delete_credit invoiceninja.invoiceninja_delete_credit Write write
integration__invoiceninja__invoiceninja_delete_expense invoiceninja.invoiceninja_delete_expense Write write
integration__invoiceninja__invoiceninja_delete_invoice invoiceninja.invoiceninja_delete_invoice Write write
integration__invoiceninja__invoiceninja_delete_payment invoiceninja.invoiceninja_delete_payment Write write
integration__invoiceninja__invoiceninja_delete_product invoiceninja.invoiceninja_delete_product Write write
integration__invoiceninja__invoiceninja_delete_project invoiceninja.invoiceninja_delete_project Write write
integration__invoiceninja__invoiceninja_delete_purchase_order invoiceninja.invoiceninja_delete_purchase_order Write write
integration__invoiceninja__invoiceninja_delete_quote invoiceninja.invoiceninja_delete_quote Write write
integration__invoiceninja__invoiceninja_delete_recurring_invoice invoiceninja.invoiceninja_delete_recurring_invoice Write write
integration__invoiceninja__invoiceninja_delete_task invoiceninja.invoiceninja_delete_task Write write
integration__invoiceninja__invoiceninja_delete_tax_rate invoiceninja.invoiceninja_delete_tax_rate Write write
integration__invoiceninja__invoiceninja_delete_vendor invoiceninja.invoiceninja_delete_vendor Write write
integration__invoiceninja__invoiceninja_get_activity invoiceninja.invoiceninja_get_activity Read read
integration__invoiceninja__invoiceninja_get_client invoiceninja.invoiceninja_get_client Read read
integration__invoiceninja__invoiceninja_get_credit invoiceninja.invoiceninja_get_credit Read read
integration__invoiceninja__invoiceninja_get_current_user invoiceninja.invoiceninja_get_current_user Read read
integration__invoiceninja__invoiceninja_get_expense invoiceninja.invoiceninja_get_expense Read read
integration__invoiceninja__invoiceninja_get_invoice invoiceninja.invoiceninja_get_invoice Read read
integration__invoiceninja__invoiceninja_get_payment invoiceninja.invoiceninja_get_payment Read read
integration__invoiceninja__invoiceninja_get_product invoiceninja.invoiceninja_get_product Read read
integration__invoiceninja__invoiceninja_get_project invoiceninja.invoiceninja_get_project Read read
integration__invoiceninja__invoiceninja_get_purchase_order invoiceninja.invoiceninja_get_purchase_order Read read
integration__invoiceninja__invoiceninja_get_quote invoiceninja.invoiceninja_get_quote Read read
integration__invoiceninja__invoiceninja_get_recurring_invoice invoiceninja.invoiceninja_get_recurring_invoice Read read
integration__invoiceninja__invoiceninja_get_task invoiceninja.invoiceninja_get_task Read read
integration__invoiceninja__invoiceninja_get_tax_rate invoiceninja.invoiceninja_get_tax_rate Read read
integration__invoiceninja__invoiceninja_get_user invoiceninja.invoiceninja_get_user Read read
integration__invoiceninja__invoiceninja_get_vendor invoiceninja.invoiceninja_get_vendor Read read
integration__invoiceninja__invoiceninja_health_check invoiceninja.invoiceninja_health_check Read read
integration__invoiceninja__invoiceninja_list_activities invoiceninja.invoiceninja_list_activities Read read
integration__invoiceninja__invoiceninja_list_clients invoiceninja.invoiceninja_list_clients Read read
integration__invoiceninja__invoiceninja_list_credits invoiceninja.invoiceninja_list_credits Read read
integration__invoiceninja__invoiceninja_list_expenses invoiceninja.invoiceninja_list_expenses Read read
integration__invoiceninja__invoiceninja_list_invoices invoiceninja.invoiceninja_list_invoices Read read
integration__invoiceninja__invoiceninja_list_payments invoiceninja.invoiceninja_list_payments Read read
integration__invoiceninja__invoiceninja_list_products invoiceninja.invoiceninja_list_products Read read
integration__invoiceninja__invoiceninja_list_projects invoiceninja.invoiceninja_list_projects Read read
integration__invoiceninja__invoiceninja_list_purchase_orders invoiceninja.invoiceninja_list_purchase_orders Read read
integration__invoiceninja__invoiceninja_list_quotes invoiceninja.invoiceninja_list_quotes Read read
integration__invoiceninja__invoiceninja_list_recurring_invoices invoiceninja.invoiceninja_list_recurring_invoices Read read
integration__invoiceninja__invoiceninja_list_tasks invoiceninja.invoiceninja_list_tasks Read read
integration__invoiceninja__invoiceninja_list_tax_rates invoiceninja.invoiceninja_list_tax_rates Read read
integration__invoiceninja__invoiceninja_list_users invoiceninja.invoiceninja_list_users Read read
integration__invoiceninja__invoiceninja_list_vendors invoiceninja.invoiceninja_list_vendors Read read
integration__invoiceninja__invoiceninja_ping invoiceninja.invoiceninja_ping Read read
integration__invoiceninja__invoiceninja_refund_payment invoiceninja.invoiceninja_refund_payment Write write
integration__invoiceninja__invoiceninja_statics invoiceninja.invoiceninja_statics Read read
integration__invoiceninja__invoiceninja_update_client invoiceninja.invoiceninja_update_client Write write
integration__invoiceninja__invoiceninja_update_credit invoiceninja.invoiceninja_update_credit Write write
integration__invoiceninja__invoiceninja_update_expense invoiceninja.invoiceninja_update_expense Write write
integration__invoiceninja__invoiceninja_update_invoice invoiceninja.invoiceninja_update_invoice Write write
integration__invoiceninja__invoiceninja_update_payment invoiceninja.invoiceninja_update_payment Write write
integration__invoiceninja__invoiceninja_update_product invoiceninja.invoiceninja_update_product Write write
integration__invoiceninja__invoiceninja_update_project invoiceninja.invoiceninja_update_project Write write
integration__invoiceninja__invoiceninja_update_purchase_order invoiceninja.invoiceninja_update_purchase_order Write write
integration__invoiceninja__invoiceninja_update_quote invoiceninja.invoiceninja_update_quote Write write
integration__invoiceninja__invoiceninja_update_recurring_invoice invoiceninja.invoiceninja_update_recurring_invoice Write write
integration__invoiceninja__invoiceninja_update_task invoiceninja.invoiceninja_update_task Write write
integration__invoiceninja__invoiceninja_update_tax_rate invoiceninja.invoiceninja_update_tax_rate Write write
integration__invoiceninja__invoiceninja_update_vendor invoiceninja.invoiceninja_update_vendor Write write

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.