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. Connect by signing in on any plan.

Professional+Compare plans

01 / MCP Integration

What is the MCP server?

The Model Context Protocol (MCP) is an open standard that lets AI assistants like Claude and ChatGPT securely connect to external tools. Our hosted MCP server lets your assistant work directly with your Invoice My Clients account, so you can run your billing workflow without leaving your conversation.

Every plan can connect an AI client by signing in, Free and Starter included; your plan's limits apply to what the client does, as in the app. Connecting with an API key instead needs the Professional plan or above. It is built for anyone who already works inside an AI assistant and wants to manage billing without switching tools.

  • Create and edit draft invoices in natural language.
  • Log billable hours and convert tracked time into invoices.
  • Look up client details and manage your list by command.
  • Check outstanding balances and overdue invoices on demand.

02 / Capabilities

What it can do

One connection gives your assistant the tools the in-app assistant uses, on your own account only, over a secure hosted endpoint.

Invoice management

Create draft invoices, add line items, and change tax, discounts, and shipping by asking your assistant in plain language.

Time tracking

Log billable hours against any client and convert unbilled time into a draft invoice with a single request.

Client management

Add new clients, update contact details, and search your list without leaving the conversation.

Outstanding balances

Ask which invoices are overdue and get totals, due dates, and what is still owed on each one.

Streamable HTTP

Connect over a hosted Streamable HTTP endpoint from Claude Code, Cursor, or any MCP-compatible client.

Sign in or API key

Clients that support MCP sign-in open Invoice My Clients in the browser and ask you to approve what they may do; other clients use an API key. Sign-in works on every plan; an API key needs Professional or above.

03 / Process

How it works

01

Add the MCP server

Add the hosted server to any MCP-compatible client as a Streamable HTTP server. Any plan can connect by signing in; see the step-by-step guide for Claude and ChatGPT in the help center.

Server URLtext
https://mcp.invoicemyclients.com/mcp
02

Sign in or use a key

If your client supports MCP sign-in, it opens Invoice My Clients in the browser and you approve the access it asks for. If not, create an API key under Settings, Developer, API Keys.

03

Ask in plain language

Tell your assistant to create an invoice for Acme or check overdue balances, and it calls the right tools.

04

Review, then approve the send

The assistant returns invoice numbers and totals from your real data. Anything that would contact a client, such as sending an invoice or resuming reminders, needs your approval: the send permission when you connect, and your OK on each send. Without it, you send from the app.

04 / FAQ

MCP Server FAQs

Which plans include the MCP server?

Every plan, Free and Starter included, when the AI client signs in (Claude, ChatGPT, Claude Code, Cursor and other clients that support MCP sign-in). The plan's limits apply to what the client does, as in the app. Connecting with an API key, and the REST API, are on Professional and above: Professional, Business, Enterprise and White Label.

What credentials do I need?

Sign in from your MCP client when it supports MCP sign-in; no key is copied. For clients that do not, create an API key in Settings, Developer, API Keys and send it as a bearer token. Revoke a key from the same page at any time.

Cursor (.cursor/mcp.json), with an API keyjson
{
  "mcpServers": {
    "invoice-my-clients": {
      "url": "https://mcp.invoicemyclients.com/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer imc_live_your_api_key"
      }
    }
  }
}
Which AI models work?

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

Is my data secure?

A sign-in grant or an API key acts only on your own account, and the server is rate limited. A signed-in client gets only the scopes you approve. Calls that would contact your clients (sending an invoice, starting a recurring send, resuming reminders) run only if you approved sending and you OK each one; automatic card charges stay in the app.

How do I connect from Claude Code?

The first command adds the server; sign in when Claude Code opens the browser. To use an API key instead, the next two lines keep it in an environment variable and pass it as a header. The last command adds the server for every project instead of only this one.

Claude Codebash
claude mcp add --transport http invoice-my-clients https://mcp.invoicemyclients.com/mcp

export IMC_API_KEY="imc_live_your_api_key"
claude mcp add --transport http invoice-my-clients https://mcp.invoicemyclients.com/mcp \
  --header "Authorization: Bearer $IMC_API_KEY"

claude mcp add --scope user --transport http invoice-my-clients https://mcp.invoicemyclients.com/mcp
Where does the MCP server run?

We host it, over Streamable HTTP. There is nothing to install or run yourself: clients that support MCP sign-in discover the login flow automatically from the server URL.

Run your billing from any AI assistant.

Sign in from your AI client or use an API key, connect the hosted MCP server, and manage invoices through conversation.

Sign in on any plan. API keys and the REST API are on Professional and above.

  • Payments processed by StripeCard numbers never touch our servers
  • Encrypted in transit and at restHTTPS only, on AWS encrypted storage
  • Passkeys and two-step sign-inOptional authenticator-app codes
  • Free plan, no card requiredUpgrade only when you need to