AI agent integrations

InvoicifyAI / Documentation

Connect your AI to InvoicifyAI.

Set up a connection, try your first request, and understand the tools and permissions behind each action.

Quick start

  1. Sign in to InvoicifyAI with an active subscription or trial and select the company you want to connect. Each person authorizes their own access.
  2. For ChatGPT, open Settings → Integrations → MCP server, choose Connect an AI client, then ChatGPT. In Connect ChatGPT, choose Add to ChatGPT to open the plugin listing. This action connects to your live InvoicifyAI account; a small note clarifies this outside production. Custom setup is available in the same drawer for a direct connection to the current environment.
  3. Install the ChatGPT plugin, or add the server in another AI client using the instructions below. Sign in to InvoicifyAI in the browser, check the selected company and requested permissions, then choose Authorize.
  4. Return to your AI client, enable the connection for the conversation, and try the read-only prompt below.
MCP server URL
https://mcp.invoicifyai.com/mcp

Other MCP clients and advanced custom connections use this address. The address contains no password or API key; signing in and approving access is still required.

Transport
Streamable HTTP
Authentication
OAuth with PKCE S256
API key
No API key or client secret needed for the documented sign-in flows
Read-only test prompt
Use InvoicifyAI to show my overdue invoices and outstanding balances by currency. Tell me which information is unavailable. Do not change or send anything.

A successful test returns fresh InvoicifyAI records, a verified empty result, or an explicit permission gap. It must not create, send, book, or record a payment. Check the connection in Settings → Integrations afterward.

Setup by client

ChatGPT uses the published plugin listing. Other clients use the connection instructions below. The Connect ChatGPT drawer also offers collapsed Custom setup in both staging and production, using that environment’s server URL.

ChatGPTWeb app

InvoicifyAI is available in ChatGPT Plugins. Choose Add to ChatGPT to open the published listing, install the plugin, then connect your account through OAuth. You do not need to paste a server URL for the published plugin. Availability and actions depend on your ChatGPT account and workspace policy; labels can vary by account.

Add to ChatGPT
  1. Choose Add to ChatGPT to open the InvoicifyAI plugin listing, then install the plugin.
  2. Connect your InvoicifyAI account in ChatGPT. Sign in, check your company and requested permissions, then choose Authorize.
  3. Return to ChatGPT and select InvoicifyAI in your conversation. Try a read-only request, then refresh your connections in InvoicifyAI.
Official ChatGPT setup guidance
ClaudeWeb app and desktop

Remote custom connectors are available on Free, Pro, Max, Team, and Enterprise. Free allows one custom connector. On Team and Enterprise, an organization owner adds the connector first; each member authorizes their own access. Enable the connector in the conversation's tools menu.

  1. Open Customize → Connectors in Claude. Some versions show connectors in settings.
  2. Add a custom connector and paste the server URL.
  3. Leave the advanced OAuth fields empty. Claude identifies itself to InvoicifyAI with its own metadata document.
  4. Connect. Claude opens InvoicifyAI to ask for permission. Choose Authorize.
Official Claude setup guidance
Meta MuseWeb and mobile

Meta Muse is a preview integration for the US and Canada. Start with the setup message below. Availability depends on the client registration enabled for your environment; check Settings → Integrations if setup is unavailable. This is the Muse connector, not a general WhatsApp API integration.

Meta Muse setup message
Add my InvoicifyAI MCP connector:

https://mcp.invoicifyai.com/mcp

Setup: standard MCP over Streamable HTTP with OAuth. Open the InvoicifyAI sign-in and authorization page, show me the requested permissions, and wait for my approval. Do not ask me for an API key, client secret, or password.

Skill: whenever I ask about customers, invoices, estimates, receivables, pipeline, AI calls, expenses, services, or appointments, use InvoicifyAI as the source of truth. Never guess missing information or treat old conversation memory as current business data.

Before making a change, show me exactly what will happen and ask me to confirm. After making a change, read the saved result back to verify it.

Once connected, give me a read-only summary of my receivables, current pipeline, and recent AI calls. Tell me the one issue that needs my attention most.
  1. Open Muse and start a conversation.
  2. Paste the setup message above, then choose Add when Muse shows the connector.
  3. Sign in to InvoicifyAI, review the permissions, and choose Authorize.
  4. Return to Muse and wait for it to confirm the connection.
Claude CodeTerminal

Use a current Claude Code release with remote HTTP and OAuth support. A compatible release can identify itself automatically. If a client ID is required, use the registered ID supplied for your environment; do not invent one. These commands configure the InvoicifyAI connection. They do not run a business action.

  1. Run this in your project.
    Claude Code: Run this in your project.
    claude mcp add --transport http invoicifyai https://mcp.invoicifyai.com/mcp
  2. Sign in.
    Claude Code: Sign in.
    claude mcp login invoicifyai

    Or run /mcp inside Claude Code and choose invoicifyai.

  3. Your browser opens InvoicifyAI. Choose Authorize.
Official Claude Code setup guidance
CodexTerminal

These commands configure the Codex CLI. Use a current release that supports remote HTTP, OAuth, and client metadata documents. The CLI configuration is separate from the published ChatGPT plugin. Run codex mcp list to check the configured server.

  1. Add the server.
    Codex: Add the server.
    codex mcp add invoicifyai --url https://mcp.invoicifyai.com/mcp
  2. Sign in.
    Codex: Sign in.
    codex mcp login invoicifyai

    Codex identifies itself with its own metadata document. No client ID is needed.

  3. Your browser opens InvoicifyAI. Choose Authorize.
Official Codex setup guidance
Another MCP clientAny client with remote MCP and OAuth

Compatibility requires Streamable HTTP and browser-based OAuth with PKCE S256. A client must identify itself with a supported HTTPS client metadata document, or use a registered client ID and matching redirect URI. Support is not guaranteed for every MCP client. Clients that require only an API key or legacy SSE need a different integration.

  1. Add a remote MCP server with the server URL.
  2. Use OAuth 2.1 with PKCE S256. Client authentication is none. Paste the client ID if your client asks.
  3. When the client opens InvoicifyAI, choose Authorize.

If your client asks for an OAuth client ID, obtain a supported registration for that client. There is no universal client ID, API-key fallback, or unattended sign-in flow to copy from this page.

Example workflows

Ask for an outcome in plain language. Your AI chooses tools from the permissions you approved.

Read the business

Read the business prompt
Use InvoicifyAI to show my overdue invoices and outstanding balances by currency. Tell me which information is unavailable. Do not change or send anything.

A fresh read. Draft invoices are separate from issued receivables; currencies stay separate.

Prepare a draft

Prepare a draft prompt
Find the customer Patel Renovations. Use my product catalog to preview an unsent invoice for two hours of labour. Ask me for the item and unit price if there is no matching product. Ask me before saving, and read the saved draft back. Do not send it.

Resolve the customer and product price first. Saving a draft and emailing it are separate actions.

Catch up on calls

Catch up on calls prompt
Read my recent AI calls and summarize the latest saved transcript. Tell me if a transcript is missing. Do not call or message anyone.

Reads saved call records. This connection does not place a live call.

Review appointments

Review appointments prompt
Show my scheduled appointments for the next seven days, with their times and timezones.

Reads stored appointments. Availability search, booking, rescheduling and cancellation are currently unavailable through MCP.

Permissions and safety

  • Your company and role apply. Access is scoped to the authorized company. Viewers can read approved data; writes require at least a Member role. Owning a connection does not override company permissions or product access.
  • Reads and writes are separate. Creating drafts, emailing documents, recording payments, and updating CRM tasks have distinct scopes. Grant only the permissions you intend to use.
  • Review the action in your chat. InvoicifyAI instructs the AI to show the exact summary and obtain confirmation before each send, payment, or estimate conversion. Client approval behavior can vary; these instructions are not a separate server-side approval screen. Check the customer, amount, recipient, dates, and timezone before approving.
  • Saving and sending are separate. A draft remains unsent until a send action. Sending a draft can issue it and affect receivables. Recording a payment logs money already collected; it does not charge a card.
  • Read back the result. Ask the AI to verify saved records after a change. Call records and document searches can be incomplete; missing results must not be treated as proof that no records exist.
  • Disconnect when needed. Open Settings → Integrations and disconnect the connection. Owners can also disconnect teammates' connections. Revocation ends that connection's access; it does not undo earlier changes or delete conversations already stored by the AI provider.

The AI provider receives the records returned for your requests. Its conversation retention is governed by its own settings and policies. See our Privacy Policy and Terms.

Available capabilities

InvoicifyAI groups connected actions into the capabilities below. The exact tools and input fields are not a public catalog: after OAuth, your AI client receives only the tools currently enabled for that connection, company role, approved permissions, subscription, and product rollout.

Customers and CRM

Read authorized customer, lead, opportunity, task, and activity information. Approved write access can create or update selected workspace records.

Sales and finance

Review invoices, estimates, receipts, products, taxes, discounts, receivables, and revenue summaries. Drafting, sending, conversion, and payment recording remain separate actions.

Documents and expenses

Search permitted documents and expense records, with availability determined by your plan, workspace role, and approved permissions.

Services and appointments

Review supported service and appointment information. Scheduling actions are available only when the connected workflow and workspace settings allow them.

AI calls

Review saved AI call activity and, where enabled, prepare or manage bounded Call for Me requests under the workspace's calling and permission controls.

Workspace and search

Read workspace context and search across supported records without bypassing company, role, subscription, or connection limits.

Reads do not authorize writes. Actions that send a document, record a payment, change a customer record, book work, or contact someone require the applicable permission and server-side checks. Compatible MCP clients discover their authorized schemas through tools/list after sign-in.

Discovery and workflow guides

Find the connection through our AI Catalog. It links to the current MCP Server Card, which describes the server and how to reach it. Sign in through OAuth to discover the tools available to your connection.

Use the workflow guide index to find instructions for common tasks:

Guides do not grant access or authorize additional actions. Your connected company, role, approved permissions, and feature access still apply.

Developer notes

Most users only need the client setup and prompts. If you build an MCP client, discover the authorized schemas through tools/list and call tools through tools/call. This endpoint is not a general REST API.

Advanced ChatGPT custom-server setup

Custom setup is an alternative in both production and staging. The published plugin always connects to production. Do not use its listing to test a staging or local server.

In the environment you want to connect, open Settings → Integrations → MCP server, choose Connect an AI client, then ChatGPT, and expand Custom setup. Use only the server URL and instructions inside that section; the public MCP address above is the production endpoint.

  • Use the client's OAuth discovery flow. Public clients use PKCE S256 and no client secret. Metadata documents and registered clients are supported subject to server validation and redirect rules.
  • Use opaque references returned by tools. Do not invent customer, document, member, capability, or appointment references. Keep monetary values separated by currency and scheduling values tied to the workspace timezone.
  • Supply the required idempotency key for each write. Retry an uncertain outcome with the same key and identical inputs. Reusing a key for different input is invalid. After a confirmed refusal, refresh state and prepare a new action with a new key.
  • Copy current version and revision tokens from fresh reads. Treat them as opaque; do not increment them yourself. A conflict needs a new read and a reviewed preview.
  • Inspect the tool result and any error before reporting success. Verify changes with the corresponding read tool. Permission denial, unavailable data, and a verified empty result are different outcomes.
  • Appointment tools currently read stored schedules. Use InvoicifyAI to manage bookings; MCP appointment actions are unavailable.

Troubleshooting

I cannot install or connect the ChatGPT plugin

Open the InvoicifyAI listing while signed in to ChatGPT, or search for InvoicifyAI in ChatGPT Plugins. Check your account availability and workspace policy with your admin. The published plugin uses its own install flow; custom-server setup is reserved for advanced or non-production connections.

Sign-in succeeds, but the connector is not ready

Return to the AI client, finish its tool scan, and enable InvoicifyAI for the conversation. Then send the read-only test prompt. In Settings → Integrations, check the connection status and refresh. A pending sign-in alone does not prove that tools have been used.

A tool is missing or access is denied

Check your company role, subscription, and approved permissions. Ask an owner about role or feature access; reconnect if you need different scopes. A missing permission is not evidence that your business has no matching records.

OAuth reports an unknown client or redirect mismatch

Update the client and use the documented OAuth flow. Leave optional credentials blank for clients that identify themselves automatically. Other clients need a registered client ID and its exact redirect URI. Contact support with the client name and version; do not paste a token or client secret.

The connection expired or was disconnected

Reconnect from Settings → Integrations and authorize again. An inactive subscription can block business actions while existing connections remain listed for disconnection. Each teammate signs in and approves their own access.

A record changed before my edit completed

Read the record again and review a new preview. The server rejects stale revision or version references. Do not reuse an old preview for a changed invoice, customer, or appointment.

An action timed out or returned an uncertain result

Ask the client to read the record or action status before trying again. Developer clients should retry an unknown outcome with the same idempotency key and identical inputs. Do not generate a new key just because the response was lost. Stop and contact support if the outcome cannot be verified.

Opening the server URL in a browser shows an error

The MCP address is a protocol endpoint, not a web page. Use it inside a compatible MCP client's setup. It requires OAuth; direct unauthenticated requests are refused. Use Streamable HTTP rather than a legacy SSE connection.

ChatGPT still shows old tools after an update

Published plugin tool updates go through OpenAI review. Start a new conversation with the installed plugin and check with support if a tool is still missing. For an advanced custom MCP connection, refresh its metadata in ChatGPT Plugins after a server update. Recreating a custom server is not required to install the published plugin.

Get help

Email support@invoicifyai.com for connection help.

Include the AI client and version, the failed step, the time and timezone, and the error text. Redact customer information and never include passwords, authorization codes, access tokens, or client secrets.