MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Hand tasks from Claude Code, Cursor or Codex to a personal agent through a folder of markdown notes.
Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
A privacy-first app that strips AI watermarks from content you own.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 26/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 12/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 0/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 38/100 |
Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: 43 (Nur im Tab Im Trend verwendet)
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Mit einem Satz von deiner KI installieren lassen
Installiere bitte handoff-desk. Folge https://mcp.popnx.com/i/voyageurworks-handoff-desk.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server handoff-desk für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "handoff-desk": { "command": "npx", "args": [ "-y", "@voyageurworks/handoff-desk" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von handoff-desk wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
SettingsDeveloperEdit Config
{
"mcpServers": {
"handoff-desk": {
"command": "npx",
"args": [
"-y",
"@voyageurworks/handoff-desk"
]
}
}
}Nutze handoff-desk und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es handoff-desk nutzt, oder ein Werkzeug von handoff-desk in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
HANDOFF_DIR Ordner, der den Desk (die Markdown-Notizen) enthält. Standardmäßig ein Ordner namens handoff im Home-Verzeichnis. HANDOFF_TELEGRAM_BOT_TOKEN Optionale Telegram-Türklingel: das Token des Bots (oder HANDOFF_TELEGRAM_BOT_TOKEN_COMMAND verwenden). HANDOFF_TELEGRAM_CHAT_ID Optionale Telegram-Türklingel: der Chat, in den der Bot schreibt. HANDOFF_SLACK_WEBHOOK_URL Optionaler Slack-Benachrichtigungsweg: eine URL für eingehende Webhooks (oder HANDOFF_SLACK_WEBHOOK_COMMAND verwenden). HANDOFF_NOTIFY_INCLUDE_REQUEST Auf 1 setzen, um eine verkürzte Anfrage zu Telegram- und Slack-Nachrichten hinzuzufügen. Standardmäßig deaktiviert. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann handoff-desk noch nicht verbinden
handoff-desk läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
A · Eine App nutzen, die handoff-desk verbinden kann
Klappt mit Claude Code, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server handoff-desk für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user handoff-desk -- npx -y @voyageurworks/handoff-desk 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von handoff-desk wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
claude mcp add --scope user handoff-desk -- npx -y @voyageurworks/handoff-deskhandoff-desk sollte in der Liste als verbunden erscheinen
Nutze handoff-desk und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es handoff-desk nutzt, oder ein Werkzeug von handoff-desk in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
HANDOFF_DIR Ordner, der den Desk (die Markdown-Notizen) enthält. Standardmäßig ein Ordner namens handoff im Home-Verzeichnis. HANDOFF_TELEGRAM_BOT_TOKEN Optionale Telegram-Türklingel: das Token des Bots (oder HANDOFF_TELEGRAM_BOT_TOKEN_COMMAND verwenden). HANDOFF_TELEGRAM_CHAT_ID Optionale Telegram-Türklingel: der Chat, in den der Bot schreibt. HANDOFF_SLACK_WEBHOOK_URL Optionaler Slack-Benachrichtigungsweg: eine URL für eingehende Webhooks (oder HANDOFF_SLACK_WEBHOOK_COMMAND verwenden). HANDOFF_NOTIFY_INCLUDE_REQUEST Auf 1 setzen, um eine verkürzte Anfrage zu Telegram- und Slack-Nachrichten hinzuzufügen. Standardmäßig deaktiviert. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server handoff-desk für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "handoff-desk": { "command": "npx", "args": [ "-y", "@voyageurworks/handoff-desk" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von handoff-desk wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Nutze handoff-desk und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es handoff-desk nutzt, oder ein Werkzeug von handoff-desk in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
HANDOFF_DIR Ordner, der den Desk (die Markdown-Notizen) enthält. Standardmäßig ein Ordner namens handoff im Home-Verzeichnis. HANDOFF_TELEGRAM_BOT_TOKEN Optionale Telegram-Türklingel: das Token des Bots (oder HANDOFF_TELEGRAM_BOT_TOKEN_COMMAND verwenden). HANDOFF_TELEGRAM_CHAT_ID Optionale Telegram-Türklingel: der Chat, in den der Bot schreibt. HANDOFF_SLACK_WEBHOOK_URL Optionaler Slack-Benachrichtigungsweg: eine URL für eingehende Webhooks (oder HANDOFF_SLACK_WEBHOOK_COMMAND verwenden). HANDOFF_NOTIFY_INCLUDE_REQUEST Auf 1 setzen, um eine verkürzte Anfrage zu Telegram- und Slack-Nachrichten hinzuzufügen. Standardmäßig deaktiviert. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server handoff-desk für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "handoff-desk": { "type": "stdio", "command": "npx", "args": [ "-y", "@voyageurworks/handoff-desk" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von handoff-desk wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
VS Code fragt nach einer Bestätigung; klicke Install
Nutze handoff-desk und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es handoff-desk nutzt, oder ein Werkzeug von handoff-desk in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
HANDOFF_DIR Ordner, der den Desk (die Markdown-Notizen) enthält. Standardmäßig ein Ordner namens handoff im Home-Verzeichnis. HANDOFF_TELEGRAM_BOT_TOKEN Optionale Telegram-Türklingel: das Token des Bots (oder HANDOFF_TELEGRAM_BOT_TOKEN_COMMAND verwenden). HANDOFF_TELEGRAM_CHAT_ID Optionale Telegram-Türklingel: der Chat, in den der Bot schreibt. HANDOFF_SLACK_WEBHOOK_URL Optionaler Slack-Benachrichtigungsweg: eine URL für eingehende Webhooks (oder HANDOFF_SLACK_WEBHOOK_COMMAND verwenden). HANDOFF_NOTIFY_INCLUDE_REQUEST Auf 1 setzen, um eine verkürzte Anfrage zu Telegram- und Slack-Nachrichten hinzuzufügen. Standardmäßig deaktiviert. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Claude Code
claude mcp add --scope user handoff-desk -- npx -y @voyageurworks/handoff-deskClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"handoff-desk": {
"command": "npx",
"args": [
"-y",
"@voyageurworks/handoff-desk"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"handoff-desk": {
"command": "npx",
"args": [
"-y",
"@voyageurworks/handoff-desk"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"handoff-desk": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@voyageurworks/handoff-desk"
]
}
}
}HANDOFF_DIR envHANDOFF_TELEGRAM_BOT_TOKEN geheim envHANDOFF_TELEGRAM_CHAT_ID envHANDOFF_SLACK_WEBHOOK_URL geheim envHANDOFF_NOTIFY_INCLUDE_REQUEST envBeschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto voyageurworks bestätigt, dem das Repo gehört
Code zuletzt geändert: vor 4 Tagen
Nutzt MIT
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Keine Einträge auf OSV.dev für @voyageurworks/handoff-desk@1.2.4
Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/voyageurworks-handoff-desk)Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Noch keine Bewertungen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt vor 4 Tagen geändert, und die neueste Version (1.2.4) kam vor 9 Tagen in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
In derselben Kategorie: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| Dieser handoff-desk | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| Läuft wo | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Wird auf deinem Rechner installiert |
| Braucht Schlüssel | Nein | Nein | Nein | Ja | Nein | Nein |
| Mit + in Claude hinzufügen | Nein | Nein | Nein | Nein | Ja | Nein |
| Basisprüfungen | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| Lizenz | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
Hand tasks from your coding session to a personal agent, and read the answer back.
handoff-desk is a small MCP server that runs on your computer. When you tell Claude Code, Cursor, Codex or another MCP client to "hand this to my agent", it writes a markdown note into a folder you own, optionally emails the agent a heads-up, and later reads the agent's reply from the same note.
New here? One command asks who sends the notes and who answers them (an agent on this computer, OpenClaw or a cloud agent), creates the desk and prints every step with your folder filled in:
npx -y @voyageurworks/handoff-desk setup
Or paste a ready-made prompt into an AI assistant that can run commands and let it do the steps. For just a demo desk:
npx -y @voyageurworks/handoff-desk init ~/handoff-demo
That creates a demo desk. The five-minute walkthrough below (add it to Claude Code, answer with a stand-in agent) needs nothing else installed but Node.js 22 or newer.
You, in Claude Code: "Hand this to my agent: book the dentist for Friday at 3."
handoff-desk writes: Desk/2026-11-02 Item 01 - Book dentist.md (status: waiting) Your agent (any): reads the note, does the task, writes "## Reply", sets status: done You, same chat: "What did my agent say?" -> the reply, read back from that note
Not to be confused with the "handoffs" inside an agent framework (one agent passing a conversation to another inside a single run). This is asynchronous and between separate programs: your coding assistant writes a note, a different agent (on your PC, in the cloud, or a person) answers when it can, and the note stays on disk as the record.
Status: 1.0. The tools and the note format are stable. Agent coverage is narrow: it is tested on every change with the bundled stand-in agent, and was tried with one real cloud agent over git and email (five rounds on 2026-10-26, all passed). Other agents are untested. See Compatibility.
sequenceDiagram
participant You as You + MCP client participant HD as handoff-desk (on your computer) participant Desk as Desk folder / private git repo participant Agent as Your agent You->>HD: handoff_send("book the dentist") HD->>Desk: write Desk/2026-10-29 Item 01 - dentist.md (status: waiting) HD-->>Agent: optional doorbell email Agent->>Desk: read note, do the task, write "## Reply", status: done You->>HD: handoff_wait / handoff_read HD->>Desk: read (and pull, with git) HD-->>You: the agent's reply
More detail, including the folder layout and the git flow, is in docs/architecture.md.
You need Node.js 22 or newer (this includes npm) and git. pnpm works too.
1. Create a demo desk. init creates Desk/, Inbox/, mail/ and a handoff.md template. Running it again never overwrites your edits. Nothing to install first; npx fetches the package from npm:
npx -y @voyageurworks/handoff-desk init ~/handoff-demo
2. Add the server to Claude Code (other clients: docs/clients.md). On macOS and Linux:
claude mcp add handoff-demo -e HANDOFF_DIR="$HOME/handoff-demo" -- npx -y @voyageurworks/handoff-desk
On Windows PowerShell, run npx through cmd /c and write the double dash in quotes (PowerShell 5.1 drops a bare --, and claude then reports missing required argument 'commandOrUrl'):
claude mcp add handoff-demo -e HANDOFF_DIR="$HOME/handoff-demo" '--' cmd /c npx -y '@voyageurworks/handoff-desk'
3. Start the stand-in agent in a second terminal and leave it running. It answers every waiting item with a fixed line. In macOS or Linux shells:
HANDOFF_DIR="$HOME/handoff-demo" npx -y @voyageurworks/handoff-desk stand-in
In Windows PowerShell:
$env:HANDOFF_DIR = "$HOME/handoff-demo"
npx -y @voyageurworks/handoff-desk stand-in
4. Try it. Start a new Claude Code session (servers load at startup) and say: "Hand this to my agent as a question using the handoff-demo tools: reply with pong." Claude calls handoff_send, then handoff_wait, and shows the stand-in's reply. Open ~/handoff-demo/Desk/ to see the note flip from status: waiting to status: done.
5. Clean up. Stop the stand-in (Ctrl+C) and run claude mcp remove handoff-demo. Delete ~/handoff-demo if you like.
init prints these commands again with your real folder filled in, and npx -y @voyageurworks/handoff-desk --help lists every command. Something not working? Run npx -y @voyageurworks/handoff-desk doctor, then see docs/troubleshooting.md.
Building from source instead (contributors)
The same server, run from a clone of this repository. In the quick-start steps above, use node /absolute/path/to/handoff-desk/dist/main.js wherever they say npx -y @voyageurworks/handoff-desk.
1. Install and build (macOS, Linux and Windows):
git clone https://github.com/voyageurworks/handoff-desk.git
cd handoff-desk npm install npm run build
With pnpm: pnpm install && pnpm build.
Releases are published to npm from GitHub Actions with a provenance statement; npm install -g @voyageurworks/handoff-desk also installs a handoff-desk command.
2. Create a demo desk. init creates Desk/, Inbox/, mail/ and a handoff.md template. Running it again never overwrites your edits.
node dist/main.js init ~/handoff-demo
3. Add the server to Claude Code (other clients: docs/clients.md). Use the absolute path to dist/main.js (on Windows with forward slashes, for example C:/Users/you/handoff-desk/dist/main.js):
claude mcp add handoff-demo -e HANDOFF_DIR="$HOME/handoff-demo" -- node /absolute/path/to/handoff-desk/dist/main.js
In Windows PowerShell 5.1, write the double dash in quotes. PowerShell drops a bare --, and claude then reports missing required argument 'commandOrUrl':
claude mcp add handoff-demo -e HANDOFF_DIR="$HOME/handoff-demo" '--' node C:/absolute/path/to/handoff-desk/dist/main.js
4. Start the stand-in agent in a second terminal and leave it running. It answers every waiting item with a fixed line. In macOS or Linux shells:
cd handoff-desk
HANDOFF_DIR="$HOME/handoff-demo" node dist/main.js stand-in
In Windows PowerShell:
cd handoff-desk
$env:HANDOFF_DIR = "$HOME/handoff-demo" node dist/main.js stand-in
handoff-desk is built for these three. In each, the assistant uses the same tools, writes the same kind of note, and your agent reads it the same way. The note's from: line says which client sent it (claude-code, cursor or codex).
| Claude Code | Cursor | Codex (CLI and IDE) | |
|---|---|---|---|
| Set up | claude mcp add | install --client cursor, or mcp.json | codex mcp add, or config.toml |
| What has been run | The real client connected to the server (Windows 11) | The config is launched by a test and the install command is tested on a copy of Cursor's settings file; the Cursor app itself has not been run | The real client started the server, called handoff_send, a note was created, answered and read back (a scripted stand-in model, Windows 11) |
| Good to know | Codex asks before calling handoff_send; approve it, or pre-approve it in config.toml (docs/clients.md) |
Any client that can run a stdio MCP server works. You give it a command, its arguments and the environment variable HANDOFF_DIR.
| Client | Guide |
|---|---|
| Claude Code | claude mcp add (above) |
| Cursor | mcp.json, see docs/clients.md |
| VS Code (Copilot agent mode) | .vscode/mcp.json, see docs/clients.md |
| Codex (CLI and IDE) | codex mcp add or config.toml, see docs/clients.md |
| Claude Desktop | claude_desktop_config.json, see docs/clients.md |
| Gemini CLI, OpenCode, Kilo Code, Amp, Continue, Goose, Junie CLI, Windsurf, LM Studio, Cline, Roo Code, Amazon Q | handoff-desk config --client or install, see docs/clients.md |
Fastest: npx -y @voyageurworks/handoff-desk install --client cursor shows what it would add to Cursor's settings (add --write to do it; Gemini CLI, LM Studio and Amp work the same way). npx -y @voyageurworks/handoff-desk doctor checks your setup and says what to fix.
Not supported yet: Kiro, Warp, the JetBrains IDEs (the Junie CLI above was run) and Zed. config --client still prints a block for each from the client's own documentation, but none has been run, so expect to adjust it (docs/clients.md).
Pick the line that matches where your agent runs.
Desk/ directly. Nothing else to set up.HANDOFF_SYNC=auto) when the folder is a git work tree with an upstream branch. Details, the exact note format and the rules to give the agent: docs/cloud-agents.md.handoff_pending and handoff_answer, and an optional wake call tells it a note is waiting. Setup, and what the wake call does and never sends: docs/openclaw.md.Whichever you pick, give the agent the rules in your handoff.md and tell it to write its answer under ## Reply and set status: done. A ready-made instruction file for the agent, usable as a Claude Code skill or pasted into any other agent's instructions, is in docs/agent-contract.md.
| Agent |