# Quipu MCP by usefulapi

> Quipu MCP by usefulapi is an MCP server. Read contacts, invoices and book entries; create contacts and draft invoices in Quipu. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/quipu/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/quipu
- **MCP Registry name:** io.usefulapi/quipu
- **Listing updated:** 2026-11-13

## About

Read contacts, invoices and book entries; create contacts and draft invoices in Quipu.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http quipu https://quipu.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://quipu.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "quipu": {
      "url": "https://quipu.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "quipu": {
      "type": "http",
      "url": "https://quipu.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "quipu": {
      "serverUrl": "https://quipu.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "quipu": {
      "type": "http",
      "url": "https://quipu.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `quipu_list_contacts`: List contacts (clients and suppliers) of the Quipu account. Filter by kind, tax id, country, email or free text.
- `quipu_get_contact`: Get one contact by id, with its totals of paid and unpaid incomes and expenses.
- `quipu_list_invoices`: List invoices (issued and received). Filter by kind, period, operation date, payment status or contact. Totals and PDF links are in the attributes.
- `quipu_get_invoice`: Get one invoice by id. Income invoices include download_pdf_url and ephemeral_open_download_pdf_url (a temporary PDF link).
- `quipu_list_book_entries`: List all book entries (invoices, tickets and other accounting entries) in one list. Filter by type, kind, period, dates, payment status or contact.
- `quipu_list_numbering_series`: List invoice numbering series (prefixes). Use a series id when you create a draft invoice.
- `quipu_list_accounting_categories`: List accounting categories (chart of accounts groups). Filter by kind, prefix or active state.
- `quipu_list_accounting_subcategories`: List accounting subcategories, optionally for one accounting category.
- `quipu_create_contact`: Create a contact (client or supplier). WRITE: it adds a record to the Quipu account. A tax id is needed before you invoice the contact.
- `quipu_update_contact`: Update fields of one contact. WRITE: it changes the record; only the fields you send change.
- `quipu_create_draft_invoice`: Create a DRAFT income invoice for a contact. WRITE: it adds a draft to Quipu. It sends no issue date or number, so Quipu does not issue or register the invoice; finalize it in the Quipu app.

## FAQ

### How do I add Quipu MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http quipu https://quipu.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/quipu-mcp-by-usefulapi
