# Invoice Ninja MCP for AI Agents AI Agent Connect > Invoice Ninja MCP lets you manage your entire billing cycle directly through your AI client. You can create invoices, track payments, and organize client details without leaving your chat interface. It connects your AI to your Invoice Ninja account so you can handle the boring stuff of running a business while staying focused on your work. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_lxTQVSXYE8JOG5kwYRUrszVoFjHXgTb0iRqAe98y/ai-agent-connect - **Tags:** invoicing, expense-tracking, time-tracking, payment-processing, freelance-tools ## Description This Connector lets you manage your entire billing cycle directly through your AI client. Most people find the administrative side of a business tedious because it requires jumping between tabs, copying client names, and double-checking product prices just to send a single bill. This connector changes that by letting your agent handle the heavy lifting. Instead of navigating a complex dashboard, you just tell your agent what needs to happen. It can pull up client details, generate new invoices on the fly, and keep your product list updated. Because it lives within the Vinkius catalog, it's easy to plug into your existing workflow and get your billing sorted in seconds. It's about moving from manual data entry to just giving instructions. You get to stay in your flow while the AI handles the paperwork. ## Tools ### create_product Add a new product to your catalog. Use this to keep your pricing current and your offerings organized. ### get_client Fetch specific details for an existing client. Use this to quickly check contact info or custom fields. ### create_client Register a new client in your system. This ensures all contact info is saved in one place for future billing. ### create_invoice Create a new invoice for a client. This makes it easy to bill for work as soon as you finish a task. ### get_invoice Retrieve a specific invoice by its ID. This helps you pull up old bills or check the status of a specific charge. ### get_payment Look up a specific payment record. Use this to confirm a customer has paid a particular invoice. ### get_product Get the details of a specific product. This is helpful for checking prices or descriptions on the fly. ### list_clients See a full list of your clients. Use this to get a bird's eye view of everyone you're doing business with. ### list_invoices View all invoices in your account. This lets you monitor your billing history and current outstanding balances. ### list_payments See all recorded payments. Use this to track your cash flow and identify which bills are settled. ### list_products See your entire product catalog. This helps you browse your available services and their current prices. ## Prompt Examples **Prompt:** ``` I just finished the logo design for Acme Corp. Can you create an invoice for $500? ``` **Response:** ``` I've created that invoice for you. **Invoice Summary** * **Client:** Acme Corp * **Amount:** $500.00 * **Status:** Draft / Ready to Send Would you like me to send it now or make any changes? ``` **Prompt:** ``` Who are my top clients and do they have any unpaid invoices? ``` **Response:** ``` Here is a summary of your recent clients and their current status: | Client Name | Last Invoice | Status | | :--- | :--- | :--- | | Acme Corp | $500.00 | Paid | | Globex | $1,200.00 | Overdue | | Initech | $750.00 | Sent | Globex is currently overdue. Would you like me to send them a reminder? ``` **Prompt:** ``` Add a new product called 'Monthly Maintenance' for $100. ``` **Response:** ``` I've added 'Monthly Maintenance' to your product catalog. **Product Details** * **Name:** Monthly Maintenance * **Price:** $100.00 * **Category:** Recurring Services You can now use this for any new recurring billing requests. ``` ## Capabilities ### Create new invoices Generate and send bills to clients instantly. ### Manage client profiles Access and update contact info for your customers. ### Track payments Check on paid and pending transactions across your account. ### Maintain product lists Add or retrieve specific items you sell. ### Fetch invoice details Pull specific billing info using an ID. ## Use Cases ### Billing a new freelance project You finish a project and need to bill the client. You tell your agent to use create_invoice for Web Design for the Acme Corp client. The agent handles the details and confirms it's sent. ### Checking payment status A client claims they paid. You ask your agent to list_payments for the last 24 hours to see if the transaction hit your account. It gives you the exact status immediately. ### Updating a product price You're raising your rates. You ask your agent to use create_product to add a new Premium Support tier. It updates your catalog so all future invoices use the new price. ### Onboarding a new client A new lead signs a contract. You tell your agent to use create_client with the info from your email. It populates the Invoice Ninja database for you instantly. ## Benefits - Stop switching tabs by handling invoices and client lookups directly within your AI client. - Reduce manual data entry errors by using create_client to populate your database from plain text. - Get instant visibility into your cash flow by using list_payments and list_invoices to check statuses. - Keep your services updated with create_product so your AI always has the right prices for new quotes. - Save time on recurring tasks by asking your agent to generate invoices for specific clients on demand. ## How It Works The bottom line is you get a voice-controlled billing department that works inside your favorite AI client. 1. Sign up for Invoice Ninja or use your existing self-hosted instance. 2. Generate an API token in your account settings. 3. Enter the token and your base URL into your agent setup to start billing. ## Frequently Asked Questions **Can I use the Invoice Ninja MCP to send bills to my customers?** Yes. You can tell your agent to create an invoice for a specific client, and it will handle the setup in your Invoice Ninja account. This lets you bill customers without having to manually navigate the billing dashboard. **How does the Invoice Ninja MCP help with my client list?** It lets you quickly add new clients or look up existing ones using natural language. You don't have to fill out long forms; just tell your agent the client's details, and it handles the rest. **Can I check if a customer has paid an invoice using the Invoice Ninja MCP?** Absolutely. You can ask your agent to check the status of a specific payment or list all recent payments. It will pull that info directly from your account so you know exactly who has paid. **Is the Invoice Ninja MCP good for managing my product prices?** It's great for that. You can ask your agent to add new products or update your catalog. This ensures your AI always has the correct pricing when you're generating quotes or invoices. **Does the Invoice Ninja MCP work with my self-hosted Invoice Ninja instance?** Yes, it does. You can connect it to your self-hosted setup by providing your custom base URL and your API token in the agent configuration. **Can I use the Invoice Ninja MCP to see my total billing history?** You can use it to list all your invoices and payments. This gives you a clear view of your billing history and current outstanding balances without having to sort through a complex UI. **Can I use this with a self-hosted Invoice Ninja instance?** Yes! You can provide a custom Base URL in the authentication settings to connect to your own server. **Does the AI Agent handle recurring invoices?** Currently, the agent focuses on creating and fetching standard invoices, clients, products, and payments. You can use the Invoice Ninja dashboard for recurring settings. **Can I process credit card payments through this agent?** No, the agent can list and retrieve payment records, but it does not act as a payment gateway to process actual credit card transactions.