Can I use Invoice Ninja as a CLI?

Yes. KosmoKrator exposes a Invoice Ninja CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Invoice Ninja through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Invoice Ninja tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Invoice Ninja credentials stored?

Invoice Ninja credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Invoice Ninja MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

accounting

Invoice Ninja MCP, CLI, and Lua Integration for AI Agents

Invoice Ninja integration docs for AI agents: MCP gateway setup, Invoice Ninja CLI commands, Lua API reference, credentials, and function schemas.

8 functions 6 read 2 write API token auth

Submit Invoice Ninja feedback View package source

Invoice Ninja for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: invoiceninja
route_slug: invoiceninja
package: invoiceninja
auth_strategy: api_token API token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Invoice Ninja CLIHeadless setup and direct function calls. Invoice Ninja MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Invoice Ninja MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Invoice Ninja.

Invoice Ninja CLI Matrix

Use these pages for direct Invoice Ninja CLI workflows in scripts, CI, cron, and agent wrappers.

CI Invoice Ninja CLI for CI. Cron Jobs Invoice Ninja CLI for cron jobs. Shell Scripts Invoice Ninja CLI for shell scripts. Headless Automation Invoice Ninja CLI for headless automation. Coding Agents Invoice Ninja CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`invoiceninja.invoiceninja_list_invoices`	Read `read`	6	List invoices from Invoice Ninja. Supports filtering by client, status, and date range with pagination.
`invoiceninja.invoiceninja_get_invoice`	Read `read`	1	Get a single invoice from Invoice Ninja by ID. Returns full invoice details including line items, client info, and payment status.
`invoiceninja.invoiceninja_create_invoice`	Write `write`	12	Create a new invoice in Invoice Ninja. Requires a client_id and at least one line item. Supports custom due dates, partial deposits, and notes.
`invoiceninja.invoiceninja_list_clients`	Read `read`	5	List clients from Invoice Ninja. Supports filtering by name, email, and ID number with pagination.
`invoiceninja.invoiceninja_create_client`	Write `write`	14	Create a new client in Invoice Ninja. Provide name and at least one contact with an email address.
`invoiceninja.invoiceninja_list_products`	Read `read`	5	List products from Invoice Ninja. Supports filtering by product key, custom value, and text search with pagination.
`invoiceninja.invoiceninja_list_payments`	Read `read`	6	List payments from Invoice Ninja. Supports filtering by client, invoice, status, and date range with pagination.
`invoiceninja.invoiceninja_get_current_user`	Read `read`	0	Get the profile of the currently authenticated Invoice Ninja user. Useful for verifying connection details and account information.