Connector guide3-minute read7 MCP tools7 languages

Connect Quipu to Gemini CLI via MCP

Quipu — Spanish invoicing and bookkeeping for autónomos and small companies: issued and received invoices, contacts, items, expenses and bank accounts. REST API, OAuth 2.0 client credentials.

HCBy HelpCode teamUpdated 3 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Quipu

Quipu

Quipu — Spanish invoicing and bookkeeping for autónomos and small companies: issued and received invoices, contacts, book entries and accounting categories. REST API, OAuth 2.0 client credentials.

tools

7

Region

ES

Category

Accounting

Authentication

OAuth 2.0

Required env vars

QUIPU_CLIENT_IDQUIPU_CLIENT_SECRET
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

Quipu — Spanish invoicing and bookkeeping for autónomos and small companies: issued and received invoices, contacts, items, expenses and bank accounts. REST API, OAuth 2.0 client credentials.

Guided setup

Connect Quipu to Gemini in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Quipu in the guided setup, then add your MCP URL to Gemini. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for Quipu

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Quipu · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Quipu, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Quipu + Gemini

Quipu — Spanish invoicing and bookkeeping for autónomos and small companies: issued and received invoices, contacts, items, expenses and bank accounts. REST API, OAuth 2.0 client credentials.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

QUIPU_CLIENT_ID, QUIPU_CLIENT_SECRET

Step 1 — Get credentials

Getting credentials

  1. In Quipu, create the API credentials for your account (see the API reference at quipuapp.github.io/api-v1-docs).
  2. You receive a client id and client secret. Quipu's API uses the client-credentials grant, so there is no browser consent step for your own account's data. The token request is sent with HTTP Basic credentials and the fixed scope ecommerce, which Quipu requires on every token request (without it: 400 invalid_scope); the adapter sends both. Tokens last 2 hours.
  3. Set QUIPU_CLIENT_ID and QUIPU_CLIENT_SECRET. AnythingMCP fetches and refreshes the access token on its own.

…(continued in the in-app connector instructions)

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Get your MCP API key from AnythingMCP → MCP Servers → your server → API keys.
  2. Save the file and restart gemini.
  3. Run /mcp inside the Gemini CLI — Quipu should be listed as available.
  4. Vertex AI Studio: pass https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID to the tools array of your request with the same X-API-Key header.

Available tools

ToolWhat it does
quipu_list_contactsList contacts — customers and suppliers — with their name, NIF, address and the country they invoice from
quipu_get_contactRead one contact by id, with their full tax data, address and the default payment terms recorded against them
quipu_list_invoicesList issued invoices with their number, date, contact, IVA and IRPF amounts, total and payment state — the revenue side
quipu_get_invoiceRead one issued invoice in full: every line with its quantity, price, IVA rate and IRPF retention, plus the totals and the payments applied
quipu_list_expensesList received expenses and supplier invoices with their date, supplier, category, IVA and total — the cost side of the ledger
quipu_list_book_entriesList the items and services in the catalogue with their code, description, unit price and default IVA rate
quipu_list_accounting_categoriesList the accounting categories expenses are filed under, so a cost breakdown uses the categories the bookkeeper actually uses

FAQ

Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with custom headers.

Next steps

Was this guide helpful?

Connect Quipu to Gemini in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Quipu in the guided setup, then add your MCP URL to Gemini. No code and no server to run.

Related guides