# Papierkram MCP by usefulapi (remote · papierkram.usefulapi.io)

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

- Trust score: 18/100 (low)
- Change this week: −46
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `papierkram.usefulapi.io`: 18/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-papierkram/papierkram.md), [page](https://verifymcp.io/servers/io-usefulapi-papierkram/papierkram)

## Channel facts

- Endpoint: `https://papierkram.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.16.3`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not yet verified: we couldn't confirm whether this endpoint requires it.
  - HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Tool Safety**: 0/100
  - Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 5 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### How do I install the Papierkram MCP by usefulapi server?

Papierkram MCP by usefulapi is a hosted endpoint at https://papierkram.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

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

### Cursor

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

### VS Code

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

### Codex

```toml
[mcp_servers.io-usefulapi-papierkram]
url = "https://papierkram.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-papierkram": {
      "type": "remote",
      "url": "https://papierkram.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-papierkram --url 'https://papierkram.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-papierkram:
    url: "https://papierkram.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-papierkram": {
      "Transport": "http",
      "Url": "https://papierkram.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-papierkram -t streamable-http -u 'https://papierkram.usefulapi.io/mcp'
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-02 (score 18, −50)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.23 → unverified
- [security regression] Tool safety: pass → unverified
- [security regression] Authorization: pass → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-11-01 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-31 (score 67, +3)

- [security improvement] Authorization: partial → pass
- [security] New tool “papierkram_update_voucher”, which the server declares destructive
- [security] New tool “papierkram_pay_voucher”, which the server declares destructive
- [functional regression] Schema quality: 130 → 148
- [functional regression] Schema quality: 4297 → 5347
- [functional improvement] MCP protocol: fail → pass
- [functional] Destructive annotations: pass → 100
- [functional] New prompt “check_bank_connections_and_transactions”
- [functional] New prompt “check_tracked_hours_on_a_project”
- [functional] New prompt “create_a_project_and_task_then_record_time”
- [functional] New prompt “prepare_a_draft_invoice_or_add_a_contact”
- [functional] New prompt “review_expense_vouchers_of_a_supplier”
- [functional] New prompt “see_which_invoices_are_still_unpaid”
- [functional] MCP protocol version: 2025-06-18 → 2025-11-25
- [functional] Server version: 1.11.0 → 1.13.0
- [functional] Server version: 1.10.0 → 1.11.0
- [functional] Server version: 1.9.0 → 1.10.0
- [functional] Server version: 1.7.2 → 1.9.0
- [functional] New tool “papierkram_create_voucher”
- [functional] New tool “papierkram_get_voucher_document”
- [functional] New tool “papierkram_get_voucher_pdf”
- [functional] New tool “papierkram_upload_voucher_document”

### 2026-10-30 (score 64, 0)

- [functional] Server version: 1.7.1 → 1.7.2
- [functional] Server version: 1.7.0 → 1.7.1

### 2026-10-29 (score 64, +1)

- [functional] Server version: 1.6.0 → 1.7.0
- [functional] Server version: 1.5.0 → 1.6.0

### 2026-10-28 (score 63, 0)

- [functional] Server version: 1.3.0 → 1.5.0

### 2026-10-27 (score 63, +1)

- [functional] Server version: 1.2.0 → 1.3.0

### 2026-10-26 (score 62, 0)

- [functional improvement] Stability: unverified → 0.03

## MCP tools (39)

### `papierkram_get_info` (~34 tokens)

Read the API version and the account's custom invoice templates (ids usable as custom_template_id when creating an invoice).

### `papierkram_list_companies` (~122 tokens)

List contacts (companies: customers and suppliers) with address, VAT id and contact data. Paged.

Input parameters:

- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).

### `papierkram_get_company` (~39 tokens)

Get one contact (company) by id, with its people.

Input parameters:

- `id` (required): Company id (from papierkram_list_companies).

### `papierkram_list_persons` (~128 tokens)

List the contact persons of one company. Paged.

Input parameters:

- `company_id` (required): Company id (from papierkram_list_companies).
- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).

### `papierkram_get_person` (~42 tokens)

Get one contact person of a company.

Input parameters:

- `company_id` (required): Company id.
- `id` (required): Person id (from papierkram_list_persons).

### `papierkram_list_invoices` (~205 tokens)

List outgoing invoices (Ausgangsrechnungen) with state (draft, ...), dates, totals and outstanding_amount. Filter by company, project or document date range. Paged.

Input parameters:

- `company_id`: Only invoices of this company.
- `document_date_range_end` (string): Only documents dated on or before this day (yyyy-mm-dd).
- `document_date_range_start` (string): Only documents dated on or after this day (yyyy-mm-dd).
- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).
- `project_id`: Only invoices of this project.

### `papierkram_get_invoice` (~41 tokens)

Get one outgoing invoice with its line items, billing address and payment term.

Input parameters:

- `id` (required): Invoice id (from papierkram_list_invoices).

### `papierkram_list_estimates` (~194 tokens)

List estimates (Angebote) with state, dates and totals. Filter by company, project or document date range. Paged.

Input parameters:

- `company_id`: Only estimates of this company.
- `document_date_range_end` (string): Only documents dated on or before this day (yyyy-mm-dd).
- `document_date_range_start` (string): Only documents dated on or after this day (yyyy-mm-dd).
- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).
- `project_id`: Only estimates of this project.

### `papierkram_get_estimate` (~35 tokens)

Get one estimate with its line items.

Input parameters:

- `id` (required): Estimate id (from papierkram_list_estimates).

### `papierkram_list_vouchers` (~210 tokens)

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.

Input parameters:

- `creditor_id`: Only vouchers of this creditor (company id of the supplier).
- `document_date_range_end` (string): Only documents dated on or before this day (yyyy-mm-dd).
- `document_date_range_start` (string): Only documents dated on or after this day (yyyy-mm-dd).
- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).
- `project_id`: Only vouchers of this project.

### `papierkram_get_voucher` (~36 tokens)

Get one expense voucher with its line items.

Input parameters:

- `id` (required): Voucher id (from papierkram_list_vouchers).

### `papierkram_list_payment_terms` (~118 tokens)

List the payment term templates (ids needed as payment_term_id when creating an invoice).

Input parameters:

- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).

### `papierkram_list_propositions` (~138 tokens)

List the stored products and services (Leistungen/Artikel) with article number, price and unit (the VAT rate is only in papierkram_get_proposition). Paged.

Input parameters:

- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).

### `papierkram_get_proposition` (~54 tokens)

Get one stored product or service, including its vat_rate (name such as 19% and rate such as 0.19).

Input parameters:

- `id` (required): Proposition id (from papierkram_list_propositions).

### `papierkram_list_projects` (~127 tokens)

List projects with dates, budget and state. Filter by company. Paged.

Input parameters:

- `company_id`: Only projects of this company.
- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).

### `papierkram_get_project` (~31 tokens)

Get one project by id.

Input parameters:

- `id` (required): Project id (from papierkram_list_projects).

### `papierkram_list_tasks` (~139 tokens)

List time-tracking tasks. Filter by project or product/service. Paged.

Input parameters:

- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).
- `project_id`: Only tasks of this project.
- `proposition_id`: Only tasks of this product/service.

### `papierkram_get_task` (~31 tokens)

Get one task by id.

Input parameters:

- `id` (required): Task id (from papierkram_list_tasks).

### `papierkram_list_time_entries` (~263 tokens)

List tracked time entries. Filter by project, task, invoice, user, billing state or start time range (RFC 3339 date-time). Paged.

Input parameters:

- `billing_state` (string): Only entries in this billing state.
- `invoice_id`: Only entries billed on this invoice.
- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).
- `project_id`: Only entries of this project.
- `start_time_range_end` (string): Only entries started at or before this time, RFC 3339.
- `start_time_range_start` (string): Only entries started at or after this time, RFC 3339, e.g. 2026-10-01T00:00:00Z.
- `task_id`: Only entries of this task.
- `user_id`: Only entries of this user (from papierkram_list_users).

### `papierkram_get_time_entry` (~35 tokens)

Get one time entry by id.

Input parameters:

- `id` (required): Time entry id (from papierkram_list_time_entries).

### `papierkram_list_bank_connections` (~128 tokens)

List the bank accounts connected to Papierkram (name, IBAN, balance data as Papierkram reports it). Paged.

Input parameters:

- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).

### `papierkram_list_bank_transactions` (~147 tokens)

List bank transactions (value, currency, usage text, booking date, counterparty). Filter by bank connection. Paged.

Input parameters:

- `bank_connection_id`: Only transactions of this bank connection (from papierkram_list_bank_connections).
- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).

### `papierkram_get_bank_transaction` (~34 tokens)

Get one bank transaction by id.

Input parameters:

- `id` (required): Transaction id (from papierkram_list_bank_transactions).

### `papierkram_list_users` (~118 tokens)

List the users of the account (ids needed as user_id for time entries and tasks).

Input parameters:

- `order_by` (string): Field to sort by, e.g. document_date. Must be used together with order_direction.
- `order_direction` (string): Sort direction. Must be used together with order_by.
- `page` (integer): Page number, 1-based (default 1). Use next_page from the previous reply.
- `page_size` (integer): Results per page, 1-100 (default 100).

### `papierkram_get_user` (~31 tokens)

Get one user by id.

Input parameters:

- `id` (required): User id (from papierkram_list_users).

### `papierkram_create_company` (~244 tokens)

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 50; the monthly quota is limited).

Input parameters:

- `bank_bic` (string): BIC.
- `bank_iban` (string): IBAN.
- `contact_type` (string, required): customer or supplier (required).
- `delivery_method` (string): How documents are delivered to this contact.
- `email` (string): E-mail address.
- `name` (string, required): Company name.
- `notes` (string): Internal notes.
- `phone` (string): Phone.
- `postal_city` (string): Postal address: city.
- `postal_country` (string): Postal address: country.
- `postal_street` (string): Postal address: street and number.
- `postal_zip` (string): Postal address: ZIP.
- `ust_idnr` (string): VAT id (USt-IdNr.), e.g. DE123456789.
- `website` (string): Website.

### `papierkram_update_company` (~214 tokens)

WRITE: change fields of an existing contact (only the fields you pass are changed). Read it first with papierkram_get_company.

Input parameters:

- `bank_bic` (string): BIC.
- `bank_iban` (string): IBAN.
- `contact_type` (string): customer or supplier.
- `delivery_method` (string): How documents are delivered to this contact.
- `email` (string): E-mail address.
- `id` (required): Company id.
- `name` (string): New company name.
- `notes` (string): Internal notes.
- `phone` (string): Phone.
- `postal_city` (string): Postal address: city.
- `postal_country` (string): Postal address: country.
- `postal_street` (string): Postal address: street and number.
- `postal_zip` (string): Postal address: ZIP.
- `ust_idnr` (string): VAT id (USt-IdNr.), e.g. DE123456789.
- `website` (string): Website.

### `papierkram_create_person` (~148 tokens)

WRITE: add a contact person to an existing company. Nothing is sent to the person. Costs Papierkram API credits (a create 10, an invoice 50; the monthly quota is limited).

Input parameters:

- `comment` (string): Comment.
- `company_id` (required): Company id.
- `department` (string): Department.
- `email` (string): E-mail address.
- `first_name` (string, required): First name.
- `last_name` (string, required): Last name.
- `mobile` (string): Mobile phone.
- `phone` (string): Phone.
- `position` (string): Position.
- `salutation` (string): Salutation, e.g. Herr or Frau.

### `papierkram_create_project` (~169 tokens)

WRITE: create a project for a customer. Costs Papierkram API credits (a create 10, an invoice 50; the monthly quota is limited).

Input parameters:

- `budget_money` (string): Money budget, e.g. 5000.00.
- `budget_time` (string): Time budget in budget_time_unit.
- `budget_time_unit` (string): Unit of budget_time.
- `budget_type` (string): Budget kind; then pass budget_money or budget_time.
- `customer_id` (required): Company id of the customer (from papierkram_list_companies).
- `description` (string): Description.
- `end_date` (string): End date yyyy-mm-dd.
- `name` (string, required): Project name.
- `start_date` (string): Start date yyyy-mm-dd.

### `papierkram_create_task` (~121 tokens)

WRITE: create a time-tracking task in a project. Costs Papierkram API credits (a create 10, an invoice 50; the monthly quota is limited).

Input parameters:

- `deadline` (string): Deadline yyyy-mm-dd.
- `name` (string, required): Task name.
- `project_id` (required): Project id (from papierkram_list_projects).
- `proposition_id`: Product/service id the time is billed with (from papierkram_list_propositions).
- `user_id`: User assigned to the task (from papierkram_list_users).

### `papierkram_create_time_entry` (~159 tokens)

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 50; the monthly quota is limited).

Input parameters:

- `comments` (string): What was done.
- `ended_at_time` (string, required): End time HH:MM.
- `entry_date` (string, required): Day of the work, yyyy-mm-dd.
- `started_at_time` (string, required): Start time HH:MM.
- `task_id` (required): Task id (from papierkram_list_tasks).
- `unbillable` (boolean): True when the time must not be billed.
- `user_id` (required): User who worked (from papierkram_list_users).

### `papierkram_create_proposition` (~201 tokens)

WRITE: create a stored product or service (Leistung/Artikel) with a price. Costs Papierkram API credits (a create 10, an invoice 50; the monthly quota is limited).

Input parameters:

- `article_no` (string, required): Article number.
- `description` (string): Description.
- `name` (string, required): Name.
- `price` (string): Net unit price, e.g. 99.50.
- `proposition_type` (string, required): service, product or ecommerce.
- `time_unit` (string, required): Time unit used for time tracking with this item.
- `unit_name_1` (string): Unit name singular, e.g. Stunde.
- `unit_name_n` (string): Unit name plural, e.g. Stunden.
- `vat_rate` (string, required): VAT rate as Papierkram writes it, e.g. 19% (see vat_rate.name of an existing item from papierkram_get_proposition).

### `papierkram_create_invoice` (~290 tokens)

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 50; the monthly quota is limited).

Input parameters:

- `contact_person_id`: Contact person of the customer (from papierkram_list_persons).
- `custom_template_id`: Custom invoice template id (from papierkram_get_info).
- `customer_id` (required): Company id of the customer (from papierkram_list_companies).
- `description` (string): Notes shown on the invoice.
- `document_date` (string): Invoice date yyyy-mm-dd (default today).
- `gross` (boolean): False (default): prices are net. True: prices are gross.
- `line_items` (array, required): The invoice lines.
- `name` (string, required): Invoice title/subject.
- `payment_term_id` (required): Payment term id (from papierkram_list_payment_terms).
- `project_id`: Project the invoice belongs to.
- `supply_date` (string): Supply/service date or period as text, e.g. 01.10.2026 - 14.10.2026.

### `papierkram_get_voucher_pdf` (~92 tokens)

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).

Input parameters:

- `id` (required): Voucher id (from papierkram_list_vouchers).

### `papierkram_get_voucher_document` (~181 tokens)

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_voucher_pdf. Files that are not yet attached to a voucher (the upload inbox) are not reachable through the Papierkram API.

Input parameters:

- `document_id`: Document id (documents[].id of papierkram_get_voucher). Needed only when the voucher has more than one document.
- `voucher_id` (required): Voucher id (from papierkram_list_vouchers).

### `papierkram_upload_voucher_document` (~154 tokens)

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.

Input parameters:

- `content_base64` (string, required): The file content as standard base64.
- `filename` (string, required): File name, e.g. receipt-2026-10-31.pdf.
- `mime_type` (string, required): Media type of the file.
- `voucher_id` (required): Voucher id (from papierkram_list_vouchers or papierkram_create_voucher).

### `papierkram_create_voucher` (~370 tokens)

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 attach the file with papierkram_upload_voucher_document and record a payment with papierkram_pay_voucher. Asset categories that need a depreciation (AfA) setting must be finished in Papierkram. Costs 50 Papierkram API credits; each duplicate check reads 1.

Input parameters:

- `allow_duplicate` (boolean): True only after the user confirmed that a reported possible duplicate is a different voucher.
- `confirm` (boolean): False or missing: preview only, nothing is created. True: book the voucher now.
- `creditor_id`: Supplier company id (from papierkram_list_companies; it must be a supplier).
- `description` (string): Notes.
- `document_date` (string, required): Receipt date yyyy-mm-dd (Belegdatum).
- `due_date` (string): Due date yyyy-mm-dd.
- `entertainment_persons` (array): Guests of a business meal (Bewirtungskosten only).
- `entertainment_reason` (string): Reason of a business meal (Bewirtungskosten only).
- `flagged` (boolean): Mark the voucher for a later check.
- `line_items` (array, required): The voucher lines.
- `name` (string, required): Voucher title, e.g. the supplier and the receipt number.
- `provenance` (string, required): Where the supplier is: domestic (Germany), eu or foreign.

### `papierkram_pay_voucher` (~253 tokens)

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, skonto = cash discount, mahnung = reminder fee, schmaelerung = reduction, sonstige = other). A repeated call books a second payment: after an error, check the voucher state with papierkram_get_voucher before retrying.

Input parameters:

- `banking_transaction_id`: Bank transaction that paid the voucher (from papierkram_list_bank_transactions).
- `confirm` (boolean): False or missing: preview only, nothing is booked. True: book the payment now.
- `difference_reason` (string): Why the value differs from the open amount.
- `id` (required): Voucher id.
- `payment_date` (string): Payment date yyyy-mm-dd (default: Papierkram's default, today).
- `value` (number): Paid amount. Needed unless banking_transaction_id is given.

### `papierkram_update_voucher` (~439 tokens)

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 to review. After approval, call again with the same arguments and confirm: true. Papierkram refuses a voucher that can no longer be edited (e.g. a paid or locked one). Lines with a billing (re-invoicing) or depreciation (AfA) setting cannot be replaced here, so the tool refuses line_items for such a voucher; change those lines in Papierkram. Payments are booked with papierkram_pay_voucher. Costs 1 Papierkram API credit; the preview, and a confirmed line change, also read the voucher (1 each).

Input parameters:

- `confirm` (boolean): False or missing: preview only, nothing is changed. True: change the voucher now.
- `creditor_id`: New supplier company id (from papierkram_list_companies; it must be a supplier).
- `description` (string): New notes.
- `document_date` (string): New receipt date yyyy-mm-dd (Belegdatum).
- `due_date` (string|null): New due date yyyy-mm-dd; null removes the due date.
- `entertainment_persons` (array): Guests of a business meal (Bewirtungskosten only).
- `entertainment_reason` (string): Reason of a business meal (Bewirtungskosten only).
- `flagged` (boolean): Mark (true) or unmark (false) the voucher for a later check.
- `id` (required): Voucher id (from papierkram_list_vouchers).
- `line_items` (array): The complete new list of voucher lines. It replaces ALL current lines.
- `name` (string): New voucher title.
- `provenance` (string): Where the supplier is: domestic (Germany), eu or foreign.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-papierkram/papierkram#diagnostics

## Score history

- 2026-11-05: 18
- 2026-11-04: 18
- 2026-11-03: 18
- 2026-11-02: 18
- 2026-11-01: 68
- 2026-10-31: 67
- 2026-10-30: 64
- 2026-10-29: 64
- 2026-10-28: 63
- 2026-10-27: 63
- 2026-10-26: 62
- 2026-10-25: 62

## Common questions

### What is the Papierkram MCP by usefulapi server?

Papierkram MCP by usefulapi is listed in the public MCP registry as io.usefulapi/papierkram. Read Papierkram invoices, vouchers, contacts, projects, time; create contacts, time, draft invoices. This page covers its hosted endpoint (https://papierkram.usefulapi.io/mcp).

### Is the Papierkram MCP by usefulapi server safe to use?

Papierkram MCP by usefulapi scores 18 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Papierkram MCP by usefulapi server expose?

Papierkram MCP by usefulapi exposes 39 tools: papierkram_get_info, papierkram_list_companies, papierkram_get_company, papierkram_list_persons, papierkram_get_person, and 34 more. Their descriptions and schemas cost roughly 5,515 tokens of context every time the server is loaded.

### Does the Papierkram MCP by usefulapi server require authentication?

Its publisher declares no required credentials for Papierkram MCP by usefulapi. We have not been able to confirm that against the live endpoint, and a server can require authorisation without declaring it here.

### Is the Papierkram MCP by usefulapi server still maintained?

Papierkram MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Papierkram MCP by usefulapi server?

VerifyMCP ran 4 checks on Papierkram MCP by usefulapi, covering TLS certificate, HSTS header, DNSSEC and Transport. 7 items could not be completed, a gap on our side rather than a finding about Papierkram MCP by usefulapi: Authorization, HTTPS, Schema quality, Stability and 3 more. 5 categories score 0 for that reason, because we only credit what we can confirm. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://papierkram.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Website: https://usefulapi.io/papierkram/
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-papierkram/papierkram.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-papierkram/papierkram/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/io-usefulapi-papierkram/papierkram.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-papierkram/papierkram