# Papierkram MCP by usefulapi

> Papierkram MCP by usefulapi is an MCP server. Read Papierkram invoices, vouchers, contacts, projects, time; create contacts, time, draft invoices. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read Papierkram invoices, vouchers, contacts, projects, time; create contacts, time, draft invoices.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `papierkram_get_info`: Read the API version and the account's custom invoice templates (ids usable as custom_template_id when creating an invoice).
- `papierkram_list_companies`: List contacts (companies: customers and suppliers) with address, VAT id and contact data. Paged.
- `papierkram_get_company`: Get one contact (company) by id, with its people.
- `papierkram_list_persons`: List the contact persons of one company. Paged.
- `papierkram_get_person`: Get one contact person of a company.
- `papierkram_list_invoices`: List outgoing invoices (Ausgangsrechnungen) with state (draft, ...), dates, totals and outstanding_amount. Filter by company, project or document date range. Paged.
- `papierkram_get_invoice`: Get one outgoing invoice with its line items, billing address and payment term.
- `papierkram_list_estimates`: List estimates (Angebote) with state, dates and totals. Filter by company, project or document date range. Paged.
- `papierkram_get_estimate`: Get one estimate with its line items.
- `papierkram_list_vouchers`: List expense vouchers (Belege / incoming invoices and receipts) with creditor, state, dates and amounts. Filter by creditor (supplier company), project or document date range. Paged.
- `papierkram_get_voucher`: Get one expense voucher with its line items.
- `papierkram_list_payment_terms`: List the payment term templates (ids needed as payment_term_id when creating an invoice).
- `papierkram_list_propositions`: List the stored products and services (Leistungen/Artikel) with article number, price and unit (the VAT rate is only in papierkram_get_proposition). Paged.
- `papierkram_get_proposition`: Get one stored product or service, including its vat_rate (name such as 19% and rate such as 0.19).
- `papierkram_list_projects`: List projects with dates, budget and state. Filter by company. Paged.
- `papierkram_get_project`: Get one project by id.
- `papierkram_list_tasks`: List time-tracking tasks. Filter by project or product/service. Paged.
- `papierkram_get_task`: Get one task by id.
- `papierkram_list_time_entries`: List tracked time entries. Filter by project, task, invoice, user, billing state or start time range (RFC 3339 date-time). Paged.
- `papierkram_get_time_entry`: Get one time entry by id.
- `papierkram_list_bank_connections`: List the bank accounts connected to Papierkram (name, IBAN, balance data as Papierkram reports it). Paged.
- `papierkram_list_bank_transactions`: List bank transactions (value, currency, usage text, booking date, counterparty). Filter by bank connection. Paged.
- `papierkram_get_bank_transaction`: Get one bank transaction by id.
- `papierkram_list_users`: List the users of the account (ids needed as user_id for time entries and tasks).
- `papierkram_get_user`: Get one user by id.
- `papierkram_create_company`: WRITE: create a contact (company) in Papierkram. Papierkram assigns the customer number. Nothing is sent to the contact. Check papierkram_list_companies first to avoid duplicates. Costs Papierkram API credits (a create 10, an invoice or estimate 50; the monthly quota is limited).
- `papierkram_update_company`: WRITE: change fields of an existing contact (only the fields you pass are changed). Read it first with papierkram_get_company.
- `papierkram_create_person`: WRITE: add a contact person to an existing company. Nothing is sent to the person. Costs Papierkram API credits (a create 10, an invoice or estimate 50; the monthly quota is limited).
- `papierkram_create_project`: WRITE: create a project for a customer. Costs Papierkram API credits (a create 10, an invoice or estimate 50; the monthly quota is limited).
- `papierkram_create_task`: WRITE: create a time-tracking task in a project. Costs Papierkram API credits (a create 10, an invoice or estimate 50; the monthly quota is limited).
- `papierkram_create_time_entry`: WRITE: record a time entry (worked time) on a task. Not billed until an invoice is made. Costs Papierkram API credits (a create 10, an invoice or estimate 50; the monthly quota is limited).
- `papierkram_create_proposition`: WRITE: create a stored product or service (Leistung/Artikel) with a price. Costs Papierkram API credits (a create 10, an invoice or estimate 50; the monthly quota is limited).
- `papierkram_create_invoice`: WRITE: create a DRAFT outgoing invoice (state draft; it is NOT finalized or sent, and gets no invoice number until the user completes it in Papierkram). Needs a payment term id (papierkram_list_payment_terms) and at least one line item. Use papierkram_list_invoices afterwards to check it. Costs Papierkram API credits (a create 10, an invoice or estimate 50; the monthly quota is limited).
- `papierkram_create_estimate`: WRITE: create a DRAFT estimate (Angebot; state draft, it is NOT finalized or sent, and gets no estimate number until the user completes it in Papierkram). Needs a customer and at least one line item (name, quantity, unit, net unit price, VAT rate). Use papierkram_list_estimates afterwards to check it. Costs 50 Papierkram API credits (the monthly quota is limited).
- `papierkram_get_voucher_pdf`: Get the PDF that Papierkram makes for one expense voucher (GET /expense/vouchers/{id}/pdf). The API reference does not say whether it embeds the uploaded receipt; for the original uploaded file use papierkram_get_voucher_document. Returns the PDF as an embedded file (up to 3 MB).
- `papierkram_get_voucher_document`: Get an original file uploaded to an expense voucher (a receipt PDF or image), so its content can be read. Reads the voucher (papierkram_get_voucher) and fetches documents[].uri. Images come back as images, PDFs as an embedded file (up to 3 MB). The API has no documented download for one document: if Papierkram does not serve the file to an API token, the tool says so; then use papierkram_get_vouch
- `papierkram_upload_voucher_document`: WRITE: attach a file (receipt PDF or image) to an existing expense voucher (POST /expense/vouchers/{id}/documents). The file is given as base64, up to 3 MB. Check papierkram_get_voucher first: a repeated upload attaches the file twice. Costs 10 Papierkram API credits.
- `papierkram_create_voucher`: WRITE: book an expense voucher (Beleg) in Papierkram, e.g. from a receipt. Papierkram books it at once (state unpaid, no draft), so this tool works in two steps. Without confirm it creates nothing: it returns the exact request and possible duplicates (same document date, creditor and total) for the user to review. After the user approves, call again with the same arguments and confirm: true. Then 
- `papierkram_pay_voucher`: WRITE: book a payment of an expense voucher (POST /expense/vouchers/{id}/pay), with a value and payment date or with an existing bank transaction. Without confirm it changes nothing: it reads the voucher and returns the exact request for the user to review. After approval, call again with confirm: true. A value that differs from the open amount needs difference_reason (teilzahlung = part payment, 
- `papierkram_update_voucher`: WRITE: change an existing expense voucher (PUT /expense/vouchers/{id}): title, supplier, provenance, dates, notes, flag or line items (amount, VAT rate, category). Only the fields you pass are changed. line_items REPLACES all lines of the voucher: pass the full new list. Without confirm it changes nothing: it reads the voucher and returns its current values next to the exact request for the user t

## FAQ

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

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

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