# Invoice Ninja MCP > Invoice Ninja MCP handles all your client billing needs. Use it to automatically manage clients, generate accurate invoices, track products you sell, and record payments—all through natural conversation with your AI agent. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** invoicing, expense-tracking, time-tracking, payment-processing, freelance-tools ## Description This MCP gives your AI client full visibility into your financial operations. You can instantly pull up detailed client records or create a whole invoice just by asking. Need to know what product was sold last month? This MCP tracks it. It lets you manage the entire billing lifecycle, from creating a new customer record using `create_client` to generating and fetching specific invoices with `get_invoice`. You track your inventory via dedicated tools like listing products or making sure payments are recorded correctly. Instead of jumping between separate accounting software and spreadsheets, everything stays in one place. Since Vinkius hosts this MCP, you connect once from any compatible client app—Claude, Cursor, or Windsurf—and get access to all these core business functions without the hassle. ## Tools ### create_client Adds an entirely new customer record to your account. ### create_invoice Builds and issues a brand-new invoice immediately. ### create_product Adds a new item or service to your product catalog with a price and description. ### get_client Retrieves all contact and custom details for one specific client by name or ID. ### get_invoice Fetches all details for an invoice if you know its unique ID. ### get_payment Gets the full record for a single payment transaction using its ID. ### get_product Retrieves specific details about one product by its ID. ### list_clients Pulls a list of every active client in your system. ### list_invoices Provides a summary list of your most recent invoices. ### list_payments Lists multiple payments received, helping you track cash flow. ### list_products Shows you a comprehensive list of all available products in your system. ## Prompt Examples **Prompt:** ``` List my latest clients. ``` **Response:** ``` I've fetched your clients. You have Acme Corp, Globex, and Initech. ``` **Prompt:** ``` Create a new product called 'Consulting Hours' with a price of 150. ``` **Response:** ``` The product 'Consulting Hours' has been successfully created with a price of 150. ``` **Prompt:** ``` Get the details for invoice ID 12345. ``` **Response:** ``` Invoice 12345 is for $500, assigned to Acme Corp, and is currently marked as 'Sent'. ``` ## Capabilities ### Manage Client Records List existing customers, retrieve specific contact details, and add entirely new clients using dedicated tools. ### Generate and Track Invoices Create brand-new invoices or pull up the full history of any invoice by ID for quick review. ### Handle Product Inventory List available products, retrieve details on specific items, or create new product listings to update your catalog. ### Record Payments and Finances Get a list of all payments received or pull up the detailed record for a single payment transaction. ## Use Cases ### Quarterly Billing Reconciliation A small agency owner needs to know if their top five clients are up-to-date. They ask the agent to 'list my top 5 clients and check for outstanding invoices.' The agent uses `list_clients` and then iterates through `list_invoices`, giving a single status report instead of ten separate screens. ### New Service Launch A freelancer launches a new consulting package. Instead of updating three different systems, they tell the agent to 'create a product called X at $150/hr.' The agent uses `create_product` and updates the catalog instantly. ### Post-Meeting Follow Up After a discovery call, an agency manager needs to invoice. They ask the agent to 'generate an invoice for Acme Corp based on 10 hours of work.' The agent uses `get_client` and then immediately calls `create_invoice`, drafting it with accurate client details. ### Verifying a Payment A bookkeeper receives a payment notification. They ask the agent to 'confirm the details for payment ID 901.' The agent uses `get_payment` and returns all associated dates, amounts, and client names immediately. ## Benefits - Stop switching between apps. Instead of opening your accounting software, then jumping to a separate CRM, this MCP handles client data retrieval (using `get_client`) and invoice generation in one flow. - Never lose track of what you sold. You can use the tools like `list_products` and `create_product` to maintain an accurate product catalog that feeds directly into your billing documents. - Get a clear financial picture instantly. By listing payments or fetching payment details (`get_payment`), your agent compiles a cash flow report without any manual data entry. - Speed up client onboarding. Instead of manually creating records, simply ask the AI to `create_client` and give it the necessary info, keeping your CRM clean. - Drafting is fast. You can use the `list_invoices` tool to see what needs sending out next, letting you focus only on outstanding balances. ## How It Works The bottom line is, you give your AI client a single key, and it handles all the complex data calls for you. 1. Sign up for Invoice Ninja, either using their dedicated service or your self-hosted version. 2. Generate an API Token within your account settings (Settings > Advanced Settings > API Tokens). 3. Enter that token into the agent setup on Vinkius and begin automating your billing tasks. ## Frequently Asked Questions **How does the Invoice Ninja MCP handle multiple clients?** It manages them by allowing you to list all available customers (`list_clients`) and then pull specific data for any client using `get_client`. This keeps your entire roster accessible through simple requests. **Can I use the Invoice Ninja MCP to track my service offerings?** Yes, you manage this via product tools. You can list all existing products (`list_products`) or create a new one using `create_product` if you launch a new service. **Is the Invoice Ninja MCP suitable for large corporations?** It's best suited for freelancers, small businesses, and agencies. If your billing needs involve highly complex multinational tax law or massive transaction volumes, specialized ERP software is better. **How do I check if a payment was received using the Invoice Ninja MCP?** You can request to list recent payments (`list_payments`) for an overview, or use `get_payment` if you have the specific ID, giving you immediate confirmation. **Does the Invoice Ninja MCP only create invoices?** No. Besides creating invoices with `create_invoice`, it also allows you to fetch existing ones (`get_invoice`) and manage all related client data and products needed for billing.