npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

mcp-server-sevdesk

v1.6.0

Published

Safety-first MCP server for the sevDesk accounting API: invoices, receipts, banking and reports with tiered permissions and human confirmation. Unofficial.

Readme

mcp-server-sevdesk

npm CI OpenSSF Scorecard License: MIT

A safety-first Model Context Protocol server for the sevDesk accounting API. It lets AI assistants (Claude, Cursor, VS Code, Codex, …) read and work with your invoices, receipts, bank transactions and reports, with permissions you control and a human confirmation step for anything that is legally binding.

Documentation · Quick start · Tool reference · Releases · 🇩🇪 Deutsch

[!NOTE] This is an unofficial community project. It is not affiliated with, endorsed by or supported by sevdesk GmbH. "sevDesk" is a trademark of its owner.

Highlights

A sevDesk API token has full access to the whole account, and sevDesk has no sandbox. This server is built around that fact:

  • Read-only by default. Writes are opt-in tiers (write → commit → external); tools above your tier are never shown to the model.
  • Real human confirmation. Finalizing, booking, cancelling or emailing asks you, in your client or on an approval page in your browser. The model cannot approve itself.
  • No surprise side effects. Previewing a PDF never marks an invoice as sent, writes are never retried, and every write is read back and can go to a local audit log.
  • Correct for sevDesk Update 2.0. Tax rules and booking accounts are validated before anything is sent.
  • Compact, typed output. Aggregations run on the server, so the model doesn't page through hundreds of records; the fields are described in the tool reference.

Quick start

You need a sevDesk plan with API access (Buchhaltung Pro; the free trial includes it), the API token of a sevDesk user (Settings → Users → API token; ideally a user just for the assistant) and, except for the Claude Desktop extension, Node.js 22.12 or later.

  • Claude Desktop: download mcp-server-sevdesk-<version>.mcpb from the latest release, open it and paste your token (details).

  • Claude Code: store the token in the OS keychain, then add the server, or install the plugin:

    npx -y mcp-server-sevdesk token set work
    claude mcp add --env SEVDESK_API_TOKEN_KEYCHAIN=work --scope user sevdesk -- npx -y mcp-server-sevdesk
  • Cursor, VS Code, Windsurf, Codex, Zed and others start npx -y mcp-server-sevdesk with the token in the environment; Clients has the exact file for each.

  • claude.ai and the Claude mobile apps connect to a server you host in remote mode.

Then ask "What is my sevDesk account set up like?". The server starts read-only; the quickstart guide continues with enabling writes, a dry run first, and keeping the token safe.

What it can do

75 tools across 10 toolsets. The 38 read tools fill the first column; with the write tiers enabled, 37 more tools create and change data.

| Area | Read | Write (write, commit, external) | | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Account | Account overview and reference data: tax rules, booking accounts, units, countries | | | Invoices, credit notes, orders | List and get; PDFs and e-invoice XML as MCP resources; an e-invoice readiness check for outgoing invoices | Drafts, including orders (Angebot, Auftragsbestätigung, Lieferschein), invoices from orders, credit notes from invoices and dunning reminders (Mahnungen). Finalize, book payments, enshrine (festschreiben, irreversible), reset, cancel (Storno). Send by email | | Vouchers (Belege) | List and get; parse received e-invoices locally (XRechnung UBL/CII, ZUGFeRD/Factur-X) | Drafts with the receipt file attached, imports from an e-invoice. Finalize, book payments, enshrine, reset, delete drafts | | Banking | Accounts and transactions; reconciliation suggestions from the amount, the invoice number in the purpose, the counterparty and splits | Book a transaction against one or more documents (split payments, guarded against over-booking), mark it as private (Privatentnahme/-einlage), undo an assignment | | Reports | Summaries, receivables and payables aging, cash position, changes since a date, a VAT summary (UStVA boxes, ZM, OSS) and an EÜR-style profit and loss | The DATEV export (Buchungsstapel ZIP, never enshrined) | | Contacts and parts | Search and get, parts with their stock (Lagerbestand) | Create and update, including a part's stock and stockEnabled | | Advanced (off by default) | sevdesk_api_get: a read-only GET of any sevDesk endpoint no other tool covers, such as text templates. It refuses everything that could change data, return files or start jobs | |

The VAT summary is clearly marked as an estimate (accrual or cash basis). Every write tool accepts dryRun: true and then only returns exactly what it would do. Voucher drafts can be in a foreign currency, with an exchange rate or a rate date; such drafts cannot be finalized through the server (Receipts). The full generated reference is docs/tools.md.

Prompts

Ready-made workflows as MCP prompts. Clients list them next to the tools; in Claude Code they are slash commands such as /mcp__sevdesk__month_end_close.

| Prompt | What it does | Arguments | | --------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | | month_end_close | Monatsabschluss: changes, unbooked transactions, drafts, receivables and payables, VAT pre-check, profit, DATEV hand-over | month (YYYY-MM, default: previous month) | | receipt_intake | Beleg erfassen, E-Rechnung importieren: duplicate check, booking account and tax rule, voucher draft, finalize, payment | file (optional) | | dunning_run | Mahnlauf: overdue invoices, unbooked incoming payments, reminder drafts | contact (name/id), minDaysOverdue (0–3650 days); both optional | | vat_precheck | UStVA-Vorprüfung: unbooked transactions and drafts, VAT summary (Kennzahlen), ZM | period (YYYY-MM or YYYY-Qn) | | bank_reconciliation | Kontoabgleich: suggestions, bookings, private transactions, corrections | checkAccount (name/id), month (YYYY-MM); both optional |

A prompt appears only when the tools it needs are enabled; steps that need a disabled tier, toolset or folder are listed with the setting that enables them. Prompts only produce text for the assistant: every change still goes through the tools, with a dry run first and your confirmation for binding steps. Not tax advice.

Permissions and configuration

The server only reads until you enable more with SEVDESK_ALLOW: write (drafts, contacts, parts, DATEV export), commit (finalize, book, cancel, enshrine) and external (send by email). Before anything binding is sent, the server shows you exactly what will happen (amounts, recipients, the full email text) and waits for your approval; if the record changes before you approve, it asks again (Permissions; which clients can ask in the chat). All settings are environment variables in your client's server configuration; only a token is required, and everything else defaults to the safest option (Configuration).

Remote mode

With --http the server runs as a web service you host yourself (there is no hosted instance), for claude.ai and the Claude apps, an editor on another machine, or a small team. It refuses to start without authentication: OAuth, where each user connects through a consent page and the server stores no sevDesk token, or a shared bearer secret for one account. Remote mode has the quick starts, deployment, configuration and operations.

Claude Code plugin

The repository is also a Claude Code plugin marketplace: the sevdesk plugin starts this server and adds a bookkeeping skill for German tax rules, SKR03/SKR04, GoBD and e-invoices. Installing and configuring it: The plugin.

Documentation

What's next in 1.x: sending letters by post and sevDesk accounts in Austria. The changelog lists every release.

Contributing

Contributions are welcome. Start with Contributing, and please report security issues privately as described in the Security policy.

License

MIT © 2026 Justin Lanfermann