MCP server
Papierkram MCP by usefulapi
Read Papierkram invoices, vouchers, contacts, projects, time; create contacts, time…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://papierkram.usefulapi.io/mcpInstall 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