Skip to content
Back to search

sevdesk

MarketplaceWorks with Claude CodeGitHub

Bankabgleich, Belege und Rechnungen, bevor dein Steuerberater fragt.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ultra-smashed--sevdesk-skill/badge.svg)](/listings/ultra-smashed--sevdesk-skill)

HTML

<a href="/listings/ultra-smashed--sevdesk-skill"><img src="/api/listings/ultra-smashed--sevdesk-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude-App (Web, Desktop)

Am schnellsten: den Link in einen neuen Chat einfügen und Claude bitten, den Skill zu installieren:

https://github.com/Ultra-Smashed/sevdesk-skill

Installier diesen Skill für mich.

Oder von Hand:

1. [`sevdesk.zip`](https://github.com/Ultra-Smashed/sevdesk-skill/raw/main/sevdesk.zip) herunterladen (nicht entpacken). 2. In Claude unter **Settings → Capabilities** den Schalter **Code execution and file creation** einschalten. In der neueren Ansicht heißt er **Create and edit files**. 3. **Customize → Skills** öffnen, auf **+** klicken, dann **Create skill → Upload a skill** und die ZIP-Datei wählen.

Als Plugin: **Customize → Plugins**, bei den persönlichen Plugins auf **+**, dann **Add from a repository** und `Ultra-Smashed/sevdesk-skill` eintragen. Nur so kommt in Claude Desktop der lokale Server für den direkten Zugriff mit.

Die Menünamen stehen hier so, wie Anthropic sie in der Hilfe nennt. In der deutschen Oberfläche können sie übersetzt sein.

Claude Code

Als Plugin:

/plugin marketplace add Ultra-Smashed/sevdesk-skill
/plugin install sevdesk@sevdesk

Oder den Ordner kopieren:

git clone https://github.com/Ultra-Smashed/sevdesk-skill.git
cp -r sevdesk-skill/skills/sevdesk ~/.claude/skills/

Mit `cp` bekommst du nur den Skill. Er arbeitet dann über das Skript (braucht Python 3).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "sevdesk",
  4. "description": "Bankabgleich, Belege und Rechnungen, bevor dein Steuerberater fragt.",
  5. "owner": {
  6. "name": "Christopher Thanisch",
  7. "url": "https://thanisch.co"
  8. },
  9. "plugins": [
  10. {
  11. "name": "sevdesk",
  12. "description": "Räumt die Buchhaltung in sevDesk auf: Rechnungen auch in Serie, Belege, Zahlungsmoral, Bankabgleich mit fehlenden Belegen und Liquiditätsvorschau. Mit lokalem Server für den direkten Zugriff.",
  13. "source": "./",
  14. "category": "productivity"
  15. }
  16. ]
  17. }
README.md · README · 108 lines
  1. # sevDesk-Skill
  2. Ein Skill für Claude. Der sevDesk-Skill verbindet Claude mit sevDesk. Er schreibt Rechnungen, auch zehn auf einmal, macht aus Quittungsfotos Belege, zeigt dir, welcher Kunde immer zu spät zahlt, und gleicht dein Bankkonto ab: Jede Zahlung wird der richtigen Rechnung zugeordnet, und du siehst, welche Belege noch fehlen. Verbucht wird erst nach deinem Okay. Kostenlos, MIT-Lizenz.
  3. | Modul | Was es macht |
  4. | --- | --- |
  5. | **Rechnungen** | Aus einem Satz wird ein Rechnungsentwurf. Für Stammkunden auch als Serie: Claude übernimmt die Positionen vom Vormonat und legt alle auf einmal an. |
  6. | **Belege** | Quittungsfotos und PDFs werden ausgelesen, kategorisiert und als Belegentwurf mit Datei in sevDesk angelegt. |
  7. | **Zahlungsmoral** | Wie viele Tage braucht jeder Kunde im Schnitt bis zur Zahlung? Wer liegt regelmäßig über dem Zahlungsziel? Dazu die passenden Erinnerungen. |
  8. | **Bankabgleich** | Jeder ungebuchte Umsatz wird einer offenen Rechnung zugeordnet, Teil- und Sammelzahlungen inklusive. Übrig bleibt die Liste der Belege, die noch fehlen. |
  9. | **Liquidität** | Kontostand, offene Rechnungen und wiederkehrende Ausgaben ergeben eine Vorschau über drei bis sechs Monate in drei Szenarien. |
  10. ## Was du brauchst
  11. - Ein sevDesk-Konto mit Zugriff auf den API-Token (Einstellungen → Benutzer).
  12. - Für den direkten Zugriff: Claude Code oder Claude Desktop mit dem Plugin. Die Claude-App im Browser und auf dem Handy erreicht sevDesk nicht direkt (siehe unten).
  13. - Ein Claude-Konto mit eingeschalteter Code-Ausführung.
  14. ## Wo es direkt funktioniert
  15. | Wo | Was passiert |
  16. | --- | --- |
  17. | **Claude Code** | Direkt: Das Skript `scripts/sevdesk.py` spricht mit der API. |
  18. | **Claude Desktop mit Plugin** | Direkt: Das Plugin bringt einen kleinen lokalen Server mit (`mcp/server.mjs`, braucht Node.js 18+). Der Schlüssel bleibt auf deinem Rechner. |
  19. | **Claude-App (Web, Handy)** | Vorbereitungsmodus: Claude baut alles fertig, du übernimmst es selbst. Die Code-Umgebung dort erreicht nur freigegebene Seiten. |
  20. ## Installation
  21. ### Claude-App (Web, Desktop)
  22. Am schnellsten: den Link in einen neuen Chat einfügen und Claude bitten, den Skill zu installieren:
  23. ```
  24. https://github.com/Ultra-Smashed/sevdesk-skill
  25. Installier diesen Skill für mich.
  26. ```
  27. Oder von Hand:
  28. 1. [`sevdesk.zip`](https://github.com/Ultra-Smashed/sevdesk-skill/raw/main/sevdesk.zip) herunterladen (nicht entpacken).
  29. 2. In Claude unter **Settings → Capabilities** den Schalter **Code execution and file creation** einschalten. In der neueren Ansicht heißt er **Create and edit files**.
  30. 3. **Customize → Skills** öffnen, auf **+** klicken, dann **Create skill → Upload a skill** und die ZIP-Datei wählen.
  31. Als Plugin: **Customize → Plugins**, bei den persönlichen Plugins auf **+**, dann **Add from a repository** und `Ultra-Smashed/sevdesk-skill` eintragen. Nur so kommt in Claude Desktop der lokale Server für den direkten Zugriff mit.
  32. Die Menünamen stehen hier so, wie Anthropic sie in der Hilfe nennt. In der deutschen Oberfläche können sie übersetzt sein.
  33. ### Claude Code
  34. Als Plugin:
  35. ```
  36. /plugin marketplace add Ultra-Smashed/sevdesk-skill
  37. /plugin install sevdesk@sevdesk
  38. ```
  39. Oder den Ordner kopieren:
  40. ```bash
  41. git clone https://github.com/Ultra-Smashed/sevdesk-skill.git
  42. cp -r sevdesk-skill/skills/sevdesk ~/.claude/skills/
  43. ```
  44. Mit `cp` bekommst du nur den Skill. Er arbeitet dann über das Skript (braucht Python 3).
  45. ## API-Schlüssel
  46. 1. **Token holen:** In sevDesk unter Einstellungen → Benutzer deinen Benutzer öffnen. Dort steht der API-Token.
  47. 2. **Claude geben:** Beim ersten Mal fragt Claude danach. Schick ihn einmal, Claude speichert ihn auf deinem Rechner und wiederholt ihn nie.
  48. 3. **Sicher bleiben:** Der Token gibt vollen Zugriff auf deine Buchhaltung. Nur in deinen eigenen Claude-Chat kopieren.
  49. Gespeichert wird er in `~/.config/sevdesk-skill/api-key` (nur für dich lesbar). Alternativ als Umgebungsvariable `SEVDESK_API_KEY`.
  50. ## Benutzen
  51. Einfach schreiben, was du brauchst, zum Beispiel:
  52. > Mach den Bankabgleich für Oktober und zeig mir, welche Belege fehlen.
  53. > Schreib allen Retainer-Kunden die Novemberrechnung, Positionen wie im Oktober.
  54. > Welcher Kunde zahlt bei mir am spätesten? Und reicht mein Geld bis März?
  55. Rechnungen entstehen als Entwurf, und Zahlungen werden erst verbucht, wenn du die Tabelle mit den Zuordnungen bestätigt hast. Private Umsätze rät Claude nicht, es fragt nach.
  56. ## Dateien
  57. ```
  58. skills/sevdesk/SKILL.md Ablauf, Module, Regeln
  59. skills/sevdesk/modes/ eine Anleitung pro Modul
  60. skills/sevdesk/references/ Nachschlagewerk
  61. skills/sevdesk/scripts/ Hilfsskripte (Python 3, ohne Zusatzpakete)
  62. mcp/server.mjs lokaler Server für das Plugin (Node.js 18+, ohne Zusatzpakete)
  63. .mcp.json bindet den Server ins Plugin ein
  64. sevdesk.zip derselbe Skill-Ordner als ZIP für die Claude-App
  65. .claude-plugin/ plugin.json, marketplace.json
  66. ```
  67. Nach einer Änderung im Skill-Ordner die ZIP neu bauen: `cd skills && zip -r ../sevdesk.zip sevdesk`.
  68. **Keine Steuerberatung.** Der Skill ordnet, prüft und rechnet. Steuerliche Fragen klärst du mit deinem Steuerberater.
  69. Nicht mit einem echten Konto getestet, gebaut nach der offiziellen API-Dokumentation. Alles Schreibende passiert als Entwurf und erst nach deinem Okay. Fehler gern als Issue melden.
  70. Anleitung: [thanisch.co/wissen/guides/sevdesk-skill-claude](https://thanisch.co/wissen/guides/sevdesk-skill-claude)
  71. MIT-Lizenz, siehe [LICENSE](LICENSE). Von [Christopher Thanisch](https://thanisch.co).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.