Papierkram MCP Server

MCP Server for the Papierkram.de accounting API

Remote serverstreamable-httpTypeScript

What is the Papierkram MCP server?

Most payments and commerce work still happens through a UI a human drives. Papierkram MCP server moves it into the conversation instead. MCP Server for the Papierkram.de accounting API.

The short version

Go to Papierkram > Einstellungen > API and create an API key.

  • 56 tools — covering the full Papierkram API v1
  • Install via npm — run directly with npx papierkram-mcp-server — no clone needed
  • Two transports — stdio (for Claude Desktop, Cursor, Claude Code) and HTTP/SSE (for n8n, custom integrations)
  • Docker ready — for easy self-hosted deployment
  • TypeScript with Zod schema validation on all parameters

The tools it exposes

The server publishes 11 tools. What each one is for:

  • Area — Operations
  • Contacts — Companies & contact persons: list, get, create, update, delete
  • Invoices — list, get, create, update, delete, cancel, archive, send, download PDF
  • Estimates — list, get, create, update, delete, send, download PDF
  • Expenses — list, get, create, update, delete
  • Projects — list, get, create, update, delete, archive, unarchive
  • Tasks — list, get, create, update, delete
  • Banking — list, get bank connections & transactions (read-only)
  • Account — Account info, payment terms, propositions
  • Prerequisites — The Prerequisites tool exposed by this server
  • Cursor — Add to your Cursor MCP settings with the same configuration as Claude Desktop

What it needs from you

Configuration is passed through the environment: PAPIERKRAM_API_KEY, PAPIERKRAM_SUBDOMAIN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Getting it running

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

How it compares

Plenty of payments and commerce servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Papierkram's toolset — Area, Contacts, Invoices and 8 more — is a fair guide to whether it matches your workflow. It is maintained by wagner-emden-it-services; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 11 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Papierkram.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
AreaOperations
ContactsCompanies & contact persons: list, get, create, update, delete
Invoiceslist, get, create, update, delete, cancel, archive, send, download PDF
Estimateslist, get, create, update, delete, send, download PDF
Expenseslist, get, create, update, delete
Projectslist, get, create, update, delete, archive, unarchive
Taskslist, get, create, update, delete
Bankinglist, get bank connections & transactions (read-only)
AccountAccount info, payment terms, propositions
PrerequisitesThe Prerequisites tool exposed by this server.
CursorAdd to your Cursor MCP settings with the same configuration as Claude Desktop.

How to install the Papierkram MCP server

{
  "mcpServers": {
    "papierkram": {
      "command": "npx",
      "args": ["-y", "papierkram-mcp-server"],
      "env": {
        "PAPIERKRAM_API_KEY": "your-value",
        "PAPIERKRAM_SUBDOMAIN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
PAPIERKRAM_API_KEYCredential the server authenticates with.Yes
PAPIERKRAM_SUBDOMAINConfiguration value read at startup.Optional

Example prompts to try

  • Use Papierkram to Area.
  • Use Papierkram to Contacts.
  • Use Papierkram to Invoices.

Frequently asked questions

It connects Papierkram to MCP-compatible AI assistants such as Claude and Cursor, exposing 11 tools (Area, Contacts, Invoices, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Papierkram directly.