Skip to main content
Glama
Bookipi MCP Server

Bookipi MCP Server

Bookipi MCP server for ChatGPT and Claude

Bookipi connects to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev, so your AI agent can work with invoices, customers, proposals and contracts in your own Bookipi account. This repository provides a Python MCP stdio adapter for the hosted Cotlet.dev browser tools.

Unofficial, not affiliated with, endorsed by or sponsored by Bookipi.

What can an AI agent do in Bookipi?

The live Bookipi integration page describes these workflows:

  • Filter invoice lists and view archived invoices.

  • Create invoice drafts with customer details and line items.

  • Review customer correspondence and transaction history.

  • Create and edit proposal drafts.

  • Prepare contracts and website content for review.

Review amounts, recipients and document content before approving external sends, signatures or payment-related changes.

Related MCP server: Buildern MCP server

How do I connect Bookipi to ChatGPT or Claude?

  1. Get access through Cotlet.dev.

  2. Open web.bookipi.com in your Cotlet.dev Cloud Browser and sign in yourself.

  3. In ChatGPT, add an MCP connector. In Claude, add a custom connector. Use https://cotlet.dev/mcp/v1/connect and sign in through Cotlet.dev.

  4. Ask your agent to read invoice lists or prepare an unsent invoice draft.

How do I connect Codex or Claude Code?

Create an API key in the Cotlet.dev console and set COTLET_API_KEY in your environment.

Codex configuration:

[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

Claude Code:

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

How do I run the local MCP adapter?

Use Python 3.10 or newer. The adapter uses the standard library.

git clone https://github.com/cotlet-connect/bookipi-mcp.git
cd bookipi-mcp
python3 bookipi_agent.py serve

For a client that starts local MCP servers, use an absolute path to the downloaded adapter:

{"mcpServers":{"bookipi":{"command":"python3","args":["/absolute/path/bookipi-mcp/bookipi_agent.py","serve"],"env":{"COTLET_API_KEY":"your-key"}}}}

The local adapter exposes seven browser helpers: bookipi_guide, bookipi_status, bookipi_open, bookipi_read, bookipi_click, bookipi_type and bookipi_close. These are browser helpers, distinct from the hosted workflow catalog on the integration page. Call the guide first. Without an API key, listing tools works and tool calls return setup instructions.

python3 bookipi_agent.py connect
python3 bookipi_agent.py guide
python3 bookipi_agent.py status

The adapter forwards calls to https://cotlet.dev/mcp/v1; it requires a Cotlet.dev account and a signed-in Bookipi Cloud Browser. At a sign-in page, sign in yourself. Close the browser session when finished.

Does Bookipi have an official API or MCP server?

Bookipi publishes its own hosted MCP server at https://mcp.bookipi.com/mcp and a CLI for selected business operations. The live Cotlet.dev page reports vendor instructions for Claude, checked 12 November 2026. Its research did not find a general-purpose public REST API reference. Compare the official documented operations with your task and use Bookipi's own connection when it covers what you need.

What should I ask first?

Start with a read, such as "Filter invoice lists for the period I select" or "Review this customer's transaction history". For a new invoice or proposal, ask for an unsent draft and review it before approving a send. Features depend on access in your own Bookipi account.

Source: Bookipi on Cotlet.dev. Source page retrieved 20 November 2026.

Available Tools

7 tools
bookipi_clickB

Click a numbered element on the current Bookipi page.

Inputs: element (required).

bookipi_closeA

Close the Bookipi browser session when the work is done, so credits stop running.

Inputs: no named parameters.

bookipi_guideA

How to work in Bookipi (manage invoices, customers and proposals): its screens and the sign-in link. Call this first.

Inputs: task.

bookipi_openB

Open a Bookipi page in your signed-in Cloud Browser (default https://web.bookipi.com) to work with manage invoices, customers and proposals.

Inputs: url.

bookipi_readA

Read the current Bookipi page: its text and numbered buttons, links and fields.

Inputs: element.

bookipi_statusB

Check that your Cotlet.dev account and Bookipi are ready: account, credits and Bookipi connection.

Inputs: no named parameters.

bookipi_typeB

Type text into a numbered field on the current Bookipi page.

Inputs: text (required), element (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct role: guide for instructions, status for readiness checks, open/close for session lifecycle, and read/click/type for page interaction. There is no meaningful overlap between tools, so an agent can select the right one from the name and description alone.

    Naming Consistency5/5

    All tools use the consistent `bookipi_` prefix followed by a short, lowercase verb or noun (`guide`, `status`, `open`, `read`, `click`, `type`, `close`). The pattern is predictable and easy to scan.

    Tool Count5/5

    Seven tools is a well-scoped set for a browser-automation workflow: one guide, one status check, session open/close, and the essential read/click/type interaction primitives. No tool appears redundant or missing for the stated purpose.

    Completeness4/5

    The core lifecycle and interaction loop is covered: open a session, read the page, click and type, then close to stop credits. Minor gaps exist for common browser automation needs such as waiting for page loads, scrolling, or taking screenshots, but the main invoice/customer/proposal workflows are supported.

    Related MCP Connectors

    • Bokio MCP server for ChatGPT, Claude and any AI agent: create invoice, send invoice, upload receipt, create journal entry and list unpaid invoices in your own Bokio account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Bokio yourself; Cotlet does not store your password and you need no Bokio API key. About the official Bokio API: Yes, Bokio has a public REST API for invoices, customers, journal entries, uploads and supplier invoices (checked 14 Oct 2026), but it depends on your price plan and on the kind of integration: a private integration token works for one company only, and a tool that serves several companies must be registered as a public integration with OAuth 2.0. Bokio publishes no MCP server of its own. Setup and FAQ: https://cotlet.dev/integrations/bokio-api-mcp-server

      https://cotlet.dev/mcp/v1/bokio
    • Számlázz.hu MCP server for ChatGPT, Claude and any AI agent: issue invoice, cancel invoice, issue receipt, record payment and get invoice PDF in your own Számlázz.hu account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Számlázz.hu yourself; Cotlet does not store your password and you need no Számlázz.hu API key. About the official Számlázz.hu API: Yes. Számlázz.hu has an official API called Számla Agent, in operation since 2010, that issues, reverses and queries invoices and records payments over HTTP with XML (checked 14 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/szamlazz-hu-api-mcp-server

    • Holded MCP server for ChatGPT, Claude and any AI agent: create invoice, send invoice, create expense, add contact and list unpaid invoices in your own Holded account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Holded yourself; Cotlet does not store your password and you need no Holded API key. About the official Holded API: Yes, Holded has a REST API, and it is only on paid plans (checked 14 Oct 2026). You create a key in Settings > Developers > Credentials > Add API Token, choose read, write or full access per module, and the plan sets a monthly call limit. Setup and FAQ: https://cotlet.dev/integrations/holded-api-mcp-server

      https://cotlet.dev/mcp/v1/holded
    • Invoice2go MCP server for ChatGPT, Claude and any AI agent: create invoice, send invoice, send payment reminder, create estimate and list unpaid invoices in your own Invoice2go account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Invoice2go yourself; Cotlet does not store your password and you need no Invoice2go API key. About the official Invoice2go API: Invoice2go publishes no public API or self-serve API keys; its integrations site lists a REST API only as "Request this integration" (checked 8 Nov 2026). It connects through built-in integrations and a Zapier app, and has no official MCP server. Setup and FAQ: https://cotlet.dev/integrations/invoice2go-api-mcp-server

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects AI agents to a signed-in contractor account through Cotlet.dev so they can work with estimates, leads, change orders, and job costs. Supports drafting line items, tracking estimate views, reading margins and recorded costs, and reviewing changes before writes are sent.
      Elastic 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to work with a signed-in Buildern contractor account through Cotlet.dev, including estimates, schedules, budgets, bills, client invoices, project to-dos, and site diaries, with review before write operations.
      Elastic 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables ChatGPT, Claude and other AI agents to work with clients, draft quotes, manage invoices and unpaid balances in a signed-in Batappli en ligne account via Cotlet.dev, with approval required for sharing, payments, conversions and reminders.
      Elastic 2.0