archive_invoice
Archive an invoice (move out of the active list). Does not delete or cancel it.
LABSCO SUMMARY
The whole Papierkram API, with the document state machine reflected in the tools rather than left to you.
Editing and deletion are confined to drafts and a numbered invoice is cancelled with a Storno — the tools mirror those rules, so an assistant cannot quietly break the audit trail. Lists return trimmed summaries by default, which is what keeps a hundred-invoice query readable; ask for the full record only when you need it.
What it is
An MCP server for the Papierkram.de accounting API. It covers the full document lifecycle — draft an invoice, send it, cancel or archive it, download the PDF — alongside contacts, projects, tracked time, tasks and read-only banking, so an assistant can do the bookkeeping instead of describing it.
What you get
- list_companies, get_company, create_company, update_company and delete_company, plus the matching contact-person tools — customers and suppliers, and the people at them; lists return compact summaries unless you ask for the full record
- list_invoices, get_invoice, create_invoice, update_invoice and delete_invoice — invoices start as drafts and only drafts can be edited or deleted; line items carry the VAT rate as a decimal
- send_invoice, cancel_invoice, archive_invoice and download_invoice_pdf — deliver by email or finalise as PDF, which is where the invoice number is assigned; cancel a numbered invoice with a Storno document rather than deleting it
- list_estimates, get_estimate, create_estimate, update_estimate, delete_estimate, send_estimate and download_estimate_pdf — the same shape for proposals
- list_expense_vouchers, get_expense_voucher, create_expense_voucher, update_expense_voucher and delete_expense_voucher — expenses, with each line item taking a category from the fixed Papierkram account list
- list_projects, get_project, create_project, update_project, delete_project, archive_project and unarchive_project — projects, which must belong to a company
- list_time_entries, get_time_entry, create_time_entry, update_time_entry and delete_time_entry — tracked time, which needs a task and a user
- list_tasks, get_task, create_task, update_task and delete_task — tracker tasks under a project
- list_bank_connections, get_bank_connection, list_bank_transactions and get_bank_transaction — read-only banking, filterable by connection
- get_account_info, list_payment_terms, list_propositions and get_proposition — the account's plan, the payment-term IDs invoices need, and the products and services you can put on a line
Requirements
A Papierkram account with API access. Create the key under Einstellungen > API and set PAPIERKRAM_API_KEY plus PAPIERKRAM_SUBDOMAIN — the part before .papierkram.de in your URL. Clients run npx -y papierkram-mcp-server over stdio; Node.js 20 or newer. An HTTP/SSE mode on port 3001 is available via Docker for n8n and other non-stdio clients.
Setup effort
One command plus a key — npx papierkram-mcp-server, then supply credentials
USE CASES
01
Billing a month of tracked work
Pull the time entries for the project, look up the payment terms, and draft the invoice from them.
02
Sending an invoice out
Check the draft, deliver it by email or finalise it as PDF, and download the file for your records.
03
Correcting an invoice that already has a number
Issue the cancellation document rather than deleting anything, then draft the replacement.
04
Filing a receipt
Create the expense voucher with its line items and the right Papierkram category.
05
Matching payments to invoices
Read the bank transactions for the period and line them up against the outstanding invoices.
56 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
archive_project
Archive a project. Reversible via unarchive_project.
cancel_invoice
Cancel a finalised invoice by creating a cancellation document (Storno). Use for invoices that already have a number; use delete_invoice for drafts.
create_company
Create a new company/contact. Requires contact_type and name. Returns the created company with its new ID.
create_contact_person
Create a new contact person for a company. Requires company_id, first_name, last_name. Returns the created contact with its new ID.
create_estimate
Create a new estimate/proposal (Angebot). Requires name, document_date and at least one line_item (vat_rate as decimal, e.g. 0.19). Returns the created estimate with its new ID.
create_expense_voucher
Create a new expense voucher (Ausgabebeleg). Requires name, provenance, and at least one line_item. Each line_item needs a category from the fixed Papierkram account list and a vat_rate as decimal (0.19). Returns the created voucher with its new ID.
create_invoice
Create a new invoice (as a draft). Requires name, payment_term_id and at least one line_item (vat_rate as decimal, e.g. 0.19). The invoice number is assigned later via send_invoice. Returns the created draft with its ID.
create_project
Create a new project. Requires name and customer_id (a project must belong to a company). Returns the created project with its new ID.
create_task
Create a new task (Tracker-Aufgabe). Requires name and project_id (a task must belong to a project). Returns the created task with its new ID.
create_time_entry
Create a new time entry. Requires entry_date, start/end time, task_id and user_id (the API requires a task and a user). Returns the created entry with its new ID.
delete_company
Permanently delete a company/contact. Returns a confirmation string.
delete_contact_person
Permanently delete a contact person. Returns a confirmation string.
delete_estimate
Permanently delete an estimate/proposal. Returns a confirmation string.
delete_expense_voucher
Permanently delete an expense voucher. Returns a confirmation string.
delete_invoice
Permanently delete a draft invoice. Only works on draft invoices. Returns a confirmation string.
delete_project
Permanently delete a project. Returns a confirmation string.
delete_task
Permanently delete a task. Returns a confirmation string.
delete_time_entry
Permanently delete a time entry. Returns a confirmation string.
download_estimate_pdf
Download an estimate as PDF. Returns base64-encoded PDF data (content_type, base64_length, base64).
download_invoice_pdf
Download an invoice as PDF. Returns base64-encoded PDF data (content_type, base64_length, base64).
get_account_info
Get account information from Papierkram (company name, plan, subscription details).
get_bank_connection
Get the full bank connection record by ID (IBAN, BIC, account details).
get_bank_transaction
Get the full bank transaction record by ID.
get_company
Get the full company/contact record by ID.
get_contact_person
Get the full contact person record by ID (within a company).
get_estimate
Get the full estimate/proposal record by ID (line items, totals, state).
get_expense_voucher
Get the full expense voucher record by ID.
get_invoice
Get the full invoice record by ID, including invoice_no (null while still a draft), state, line items and totals.
get_project
Get the full project record by ID (budget, dates, state, customer).
get_proposition
Get a specific proposition (Ware/Dienstleistung — product/service) by ID.
get_task
Get the full task record by ID.
get_time_entry
Get the full time entry record by ID.
list_bank_connections
List bank connections in Papierkram. Returns compact summaries (id, name) by default; set compact=false for the full API response. Supports pagination.
list_bank_transactions
List bank transactions in Papierkram. Returns compact summaries (id, value, state, date, usage, counterparty) by default; set compact=false for the full API response. Filter by bank connection and paginate.
list_companies
List companies/contacts in Papierkram. Returns compact summaries (id, name, contact_type, email, customer/supplier no.) by default; set compact=false for the full API response. Supports pagination. NOTE: the Papierkram API does not filter by contact_type server-side, so contact_type filters the returned page client-side only.
list_contact_persons
List contact persons of a specific company. Returns compact summaries (id, name, email, position) by default; set compact=false for the full API response.
list_estimates
List estimates/proposals (Angebote) in Papierkram. Returns compact summaries (id, name, estimate_no, state, date, total) by default; set compact=false for the full API response. Supports pagination and filtering.
list_expense_vouchers
List expense vouchers (Ausgabebelege) in Papierkram. Returns compact summaries (id, name, voucher_no, state, dates, amount) by default; set compact=false for the full API response. Supports pagination and filtering.
list_invoices
List invoices in Papierkram. Returns compact summaries (id, name, invoice_no, state, dates, total_gross, customer) by default; set compact=false for the full API response. Supports pagination and filtering.
list_payment_terms
List payment terms (Zahlungsbedingungen). Use the returned IDs as payment_term_id when creating invoices.
list_projects
List projects in Papierkram. Returns compact summaries (id, name, record_state, dates, company_id) by default; set compact=false for the full API response. Supports pagination and filtering by company.
list_propositions
List propositions (Waren/Dienstleistungen — products and services) that can be referenced in invoices and estimates.
list_tasks
List tasks (Tracker-Aufgaben) in Papierkram. Returns compact summaries (id, name, complete, deadline, project) by default; set compact=false for the full API response. Supports pagination and filtering by project.
list_time_entries
List time entries in Papierkram. Returns compact summaries (id, times, duration, comments, task/project) by default; set compact=false for the full API response. Supports pagination and filtering.
send_estimate
Deliver an estimate. With send_via='email' the estimate is mailed (recipient, subject and body are required). With send_via='pdf' the estimate is finalised without sending an email — the PDF can then be retrieved via download_estimate_pdf. Either way Papierkram assigns the final estimate number. Finalising is not reversible.
send_invoice
Deliver an invoice. With send_via='email' the invoice is mailed (recipient, subject and body are required). With send_via='pdf' the invoice is finalised without sending an email — the PDF can then be retrieved via download_invoice_pdf. Either way Papierkram assigns the final invoice number. Finalising is not reversible.
unarchive_project
Unarchive a project (restore from archive). Reversible via archive_project.
update_company
Update an existing company/contact (partial). Only provided fields are changed.
update_contact_person
Update an existing contact person (partial). Only provided fields are changed.
update_estimate
Update an existing estimate/proposal (partial). Only provided fields are changed.
update_expense_voucher
Update an existing expense voucher (partial). Only provided fields are changed.
update_invoice
Update an existing draft invoice (partial). Only provided fields are changed. Only works on draft invoices (before send_invoice assigns the number).
update_project
Update an existing project (partial). Only provided fields are changed.
update_task
Update an existing task (partial). Only provided fields are changed.
update_time_entry
Update an existing time entry (partial). Only provided fields are changed.
BEFORE YOU INSTALL
What to know first
Tools you get
56 tools when we connected. Banking tools are read-only: you can read bank connections and transactions but not create or reconcile them.
Requires
- npx on PATH
- PAPIERKRAM_API_KEY in your environment
CONTEXT COST
Heavy Standing cost
Rated by the size of the 56 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx papierkram-mcp-serverMCP Clients
Claude Desktop, Claude Code, Cursor
JSON
{
"mcpServers": {
"papierkram": {
"command": "npx",
"args": [
"-y",
"papierkram-mcp-server"
],
"env": {
"PAPIERKRAM_API_KEY": "<YOUR_PAPIERKRAM_API_KEY>",
"PAPIERKRAM_SUBDOMAIN": "<YOUR_PAPIERKRAM_SUBDOMAIN>"
}
}
}
}Self-hosted server — Docker
SELF-HOSTED SERVER — DOCKER · TERMINAL
git clone https://github.com/Wagner-Emden-IT-Services/papierkram-mcp-server.git
cd papierkram-mcp-server
cp .env.example .env
docker compose up -d
