Skip to content
MCP server

Papierkram MCP by usefulapi

Read Papierkram invoices, vouchers, contacts, projects, time; create contacts, time…

Install
Runs
Remotely
Version
1.21.0
Listing updated
4 days ago

About Papierkram MCP by usefulapi

Papierkram MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://papierkram.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "papierkram": {
      "url": "https://papierkram.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (40)

Read directly from the server.

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

Papierkram MCP by usefulapi 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