Where does the MCP server run?

We host the MCP endpoint at mcp.invoicemyclients.com using streamable HTTP—your client connects over HTTPS with your API key. Advanced users can still run a local stdio server from source if needed.

What credentials do I need?

A Bearer token with your Invoice My Clients API key (for example imc_live_…) in the Authorization header, as shown in the example config. Create and rotate keys in Settings → Developer → API Keys.

Can I use a hosted MCP server?

Yes—that is the default. Use the streamable HTTP URL in your MCP config, keep TLS on, and never commit API keys to git.

Which AI models work?

Any assistant that supports MCP can use this server—Claude, ChatGPT with MCP support, and others. Model quality affects how well natural-language requests map to tool calls.

Are there rate limits?

Yes. The MCP API is rate limited. Abuse of the service may result in reduced access or automatic revocation of your API token.

What data leaves my machine?

Only the requests your assistant sends to the MCP server (for example, “create invoice for Acme”) and the GraphQL responses. No separate data lake—your data stays in your Invoice My Clients account.

MCP Integration

MCP Server for AI Invoicing

Connect your favorite AI assistant to Invoice My Clients using the Model Context Protocol. Create invoices, track billable hours, manage clients, and convert time entries to invoices through natural conversation.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants like Claude, ChatGPT, and others to securely connect to external tools and services. Our MCP server lets your AI assistant directly interact with your Invoice My Clients account — creating invoices, logging billable hours, converting time entries into invoices, looking up client details, and managing your billing workflow without ever leaving your conversation.

Who is it for?

Whether you are a freelancer managing a handful of clients or an agency handling hundreds of invoices, the MCP server is designed for anyone who wants to streamline their invoicing workflow using AI. If you already use an AI assistant in your daily work, this integration lets you manage your billing without switching tools.

How it works

Simply connect the Invoice My Clients MCP server to your AI assistant. Once connected, you can use natural language to create and send invoices, log billable hours, convert tracked time into invoices, add line items, check outstanding balances, manage client information, and more — all through a simple conversation.

Usage Examples

Creating an Invoice

Create an invoice for Acme Corp for $5,000 for the website redesign project, due in 30 days.

Done! I've created invoice #INV-2024-042 for Acme Corp:
• Amount: $5,000.00
• Description: Website Redesign Project
• Due date: March 15, 2025

Would you like me to send it to their email on file?

Adding Line Items

Add three line items to the latest invoice for TechStart Inc: UI Design ($2,000), Backend Development ($3,500), and QA Testing ($1,200).

Updated! Invoice #INV-2024-043 for TechStart Inc now includes:
• UI Design — $2,000.00
• Backend Development — $3,500.00
• QA Testing — $1,200.00
• New total: $6,700.00

Checking Outstanding Invoices

Which invoices are overdue right now?

You have 3 overdue invoices:
1. #INV-2024-028 — GlobalTech ($4,200) — 15 days overdue
2. #INV-2024-031 — DesignHub ($1,800) — 8 days overdue
3. #INV-2024-035 — StartupXYZ ($950) — 3 days overdue

Total outstanding: $6,950.00
Would you like me to send payment reminders?

Managing Clients

Add a new client: NovaTech Solutions, contact person Sarah Chen, email sarah@novatech.io.

Client added successfully!
• Company: NovaTech Solutions
• Contact: Sarah Chen
• Email: sarah@novatech.io

You can now create invoices for NovaTech Solutions. Want me to draft one?

Tracking Time

Log 4 hours for Acme Corp today — API integration work at $150/hr.

Time entry logged!
• Client: Acme Corp
• Duration: 4.0 hours
• Description: API integration work
• Rate: $150.00/hr
• Total: $600.00

You now have 12.5 unbilled hours for Acme Corp this month. Want me to create an invoice for all unbilled time?

Time to Invoice

Invoice all unbilled hours for GlobalTech this month.

Invoice created from tracked time!
• Invoice #INV-2026-058 — GlobalTech
• 3 time entries converted:
  – UI Design: 8h × $125 = $1,000.00
  – Frontend Dev: 14h × $150 = $2,100.00
  – Code Review: 3h × $150 = $450.00
• Total: $3,550.00
• Status: Draft

All entries marked as billed. Want me to send it?

Connect in your AI client

Add the hosted Invoice My Clients MCP server in Claude Desktop, Cursor, or any MCP-compatible client that supports streamable HTTP. Use an API key from Settings → Developer → API Keys in the Authorization header.

Example MCP config (streamable HTTP)

{
  "mcpServers": {
    "invoice-my-clients": {
      "url": "https://mcp.invoicemyclients.com/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer imc_live_your_api_key_here"
      }
    }
  }
}

Replace the placeholder with your live API key from Settings → Developer → API Keys. Some clients also support local stdio mode—see developer documentation if you self-host the MCP process.

Security and privacy

You do not run the MCP server yourself. Your AI client connects to our hosted MCP over HTTPS; we operate the service on secure infrastructure. Requests are authenticated with your Invoice My Clients API key. Treat keys as production secrets—never commit them to public repositories, rotate or revoke them in Settings → Developer → API Keys if they are exposed, and use separate keys per environment when it makes sense.

MCP Server FAQ

Common questions about setup, authentication, and what the integration can do.

Where does the MCP server run?: We host the MCP endpoint at mcp.invoicemyclients.com using streamable HTTP—your client connects over HTTPS with your API key. Advanced users can still run a local stdio server from source if needed.
What credentials do I need?: A Bearer token with your Invoice My Clients API key (for example imc_live_…) in the Authorization header, as shown in the example config. Create and rotate keys in Settings → Developer → API Keys.
Can I use a hosted MCP server?: Yes—that is the default. Use the streamable HTTP URL in your MCP config, keep TLS on, and never commit API keys to git.
Which AI models work?: Any assistant that supports MCP can use this server—Claude, ChatGPT with MCP support, and others. Model quality affects how well natural-language requests map to tool calls.
Are there rate limits?: Yes. The MCP API is rate limited. Abuse of the service may result in reduced access or automatic revocation of your API token.
What data leaves my machine?: Only the requests your assistant sends to the MCP server (for example, “create invoice for Acme”) and the GraphQL responses. No separate data lake—your data stays in your Invoice My Clients account.