{"id":"io.usefulapi/papierkram","slug":"io-usefulapi-papierkram","title":"Papierkram MCP by usefulapi","description":"Read Papierkram invoices, vouchers, contacts, projects, time; create contacts, time, draft invoices.","version":"1.21.4","publisher":{"kind":"domain","id":"usefulapi.io","label":"usefulapi.io","url":"https://usefulapi.io"},"website":"https://usefulapi.io/papierkram/","repository":"https://github.com/m190/usefulapi-mcp","remotes":[{"type":"streamable-http","url":"https://papierkram.usefulapi.io/mcp"}],"packages":[],"published":"2026-11-18","updated":"2026-11-18","status":"online","auth":"","latency_ms":1994,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"papierkram_get_info","title":"Get account info","description":"Read the API version and the account's custom invoice templates (ids usable as custom_template_id when creating an invoice).","read_only":true},{"name":"papierkram_list_companies","title":"List companies","description":"List contacts (companies: customers and suppliers) with address, VAT id and contact data. Paged.","read_only":true},{"name":"papierkram_get_company","title":"Get company","description":"Get one contact (company) by id, with its people.","read_only":true},{"name":"papierkram_list_persons","title":"List persons of a company","description":"List the contact persons of one company. Paged.","read_only":true},{"name":"papierkram_get_person","title":"Get person","description":"Get one contact person of a company.","read_only":true},{"name":"papierkram_list_invoices","title":"List invoices","description":"List outgoing invoices (Ausgangsrechnungen) with state (draft, ...), dates, totals and outstanding_amount. Filter by company, project or document date range. Paged.","read_only":true},{"name":"papierkram_get_invoice","title":"Get invoice","description":"Get one outgoing invoice with its line items, billing address and payment term.","read_only":true},{"name":"papierkram_list_estimates","title":"List estimates","description":"List estimates (Angebote) with state, dates and totals. Filter by company, project or document date range. Paged.","read_only":true},{"name":"papierkram_get_estimate","title":"Get estimate","description":"Get one estimate with its line items.","read_only":true},{"name":"papierkram_list_vouchers","title":"List expense vouchers","description":"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.","read_only":true},{"name":"papierkram_get_voucher","title":"Get expense voucher","description":"Get one expense voucher with its line items.","read_only":true},{"name":"papierkram_list_payment_terms","title":"List payment terms","description":"List the payment term templates (ids needed as payment_term_id when creating an invoice).","read_only":true},{"name":"papierkram_list_propositions","title":"List products and services","description":"List the stored products and services (Leistungen/Artikel) with article number, price and unit (the VAT rate is only in papierkram_get_proposition). Paged.","read_only":true},{"name":"papierkram_get_proposition","title":"Get product or service","description":"Get one stored product or service, including its vat_rate (name such as 19% and rate such as 0.19).","read_only":true},{"name":"papierkram_list_projects","title":"List projects","description":"List projects with dates, budget and state. Filter by company. Paged.","read_only":true},{"name":"papierkram_get_project","title":"Get project","description":"Get one project by id.","read_only":true},{"name":"papierkram_list_tasks","title":"List tasks","description":"List time-tracking tasks. Filter by project or product/service. Paged.","read_only":true},{"name":"papierkram_get_task","title":"Get task","description":"Get one task by id.","read_only":true},{"name":"papierkram_list_time_entries","title":"List time entries","description":"List tracked time entries. Filter by project, task, invoice, user, billing state or start time range (RFC 3339 date-time). Paged.","read_only":true},{"name":"papierkram_get_time_entry","title":"Get time entry","description":"Get one time entry by id.","read_only":true},{"name":"papierkram_list_bank_connections","title":"List bank connections","description":"List the bank accounts connected to Papierkram (name, IBAN, balance data as Papierkram reports it). Paged.","read_only":true},{"name":"papierkram_list_bank_transactions","title":"List bank transactions","description":"List bank transactions (value, currency, usage text, booking date, counterparty). Filter by bank connection. Paged.","read_only":true},{"name":"papierkram_get_bank_transaction","title":"Get bank transaction","description":"Get one bank transaction by id.","read_only":true},{"name":"papierkram_list_users","title":"List users","description":"List the users of the account (ids needed as user_id for time entries and tasks).","read_only":true},{"name":"papierkram_get_user","title":"Get user","description":"Get one user by id.","read_only":true},{"name":"papierkram_create_company","title":"Create company","description":"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).","read_only":false},{"name":"papierkram_update_company","title":"Update company","description":"WRITE: change fields of an existing contact (only the fields you pass are changed). Read it first with papierkram_get_company.","read_only":false},{"name":"papierkram_create_person","title":"Create person","description":"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).","read_only":false},{"name":"papierkram_create_project","title":"Create project","description":"WRITE: create a project for a customer. Costs Papierkram API credits (a create 10, an invoice or estimate 50; the monthly quota is limited).","read_only":false},{"name":"papierkram_create_task","title":"Create task","description":"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).","read_only":false},{"name":"papierkram_create_time_entry","title":"Create time entry","description":"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).","read_only":false},{"name":"papierkram_create_proposition","title":"Create product or service","description":"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).","read_only":false},{"name":"papierkram_create_invoice","title":"Create draft invoice","description":"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).","read_only":false},{"name":"papierkram_create_estimate","title":"Create draft estimate","description":"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).","read_only":false},{"name":"papierkram_get_voucher_pdf","title":"Get voucher PDF","description":"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).","read_only":true},{"name":"papierkram_get_voucher_document","title":"Get voucher document","description":"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","read_only":true},{"name":"papierkram_upload_voucher_document","title":"Upload voucher document","description":"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.","read_only":false},{"name":"papierkram_create_voucher","title":"Create expense voucher","description":"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 ","read_only":false},{"name":"papierkram_pay_voucher","title":"Pay expense voucher","description":"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, ","read_only":false},{"name":"papierkram_update_voucher","title":"Update expense voucher","description":"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","read_only":false}],"server_info":{"name":"papierkram-mcp","version":"1.21.4","title":"Papierkram MCP by usefulapi","websiteUrl":"https://usefulapi.io/papierkram/","icons":[{"src":"https://usefulapi.io/icon.svg","mimeType":"image/svg+xml","sizes":["any"]},{"src":"https://usefulapi.io/icon-256.png","mimeType":"image/png","sizes":["256x256"]}]},"category":"finance","tags":["productivity","project"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-25","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-usefulapi-papierkram/"}