Hand tasks from Claude Code, Cursor or Codex to a personal agent through a folder of markdown notes.
Connect Runs on your machine
claude mcp add handoff-desk -e HANDOFF_DIR=<HANDOFF_DIR> -e HANDOFF_TELEGRAM_BOT_TOKEN=<HANDOFF_TELEGRAM_BOT_TOKEN> -e HANDOFF_TELEGRAM_CHAT_ID=<HANDOFF_TELEGRAM_CHAT_ID> -e HANDOFF_SLACK_WEBHOOK_URL=<HANDOFF_SLACK_WEBHOOK_URL> -e HANDOFF_NOTIFY_INCLUDE_REQUEST=<HANDOFF_NOTIFY_INCLUDE_REQUEST> -- npx -y @voyageurworks/[email protected]{
"mcpServers": {
"handoff-desk": {
"command": "npx",
"args": [
"-y",
"@voyageurworks/[email protected]"
],
"env": {
"HANDOFF_DIR": "<HANDOFF_DIR>",
"HANDOFF_TELEGRAM_BOT_TOKEN": "<HANDOFF_TELEGRAM_BOT_TOKEN>",
"HANDOFF_TELEGRAM_CHAT_ID": "<HANDOFF_TELEGRAM_CHAT_ID>",
"HANDOFF_SLACK_WEBHOOK_URL": "<HANDOFF_SLACK_WEBHOOK_URL>",
"HANDOFF_NOTIFY_INCLUDE_REQUEST": "<HANDOFF_NOTIFY_INCLUDE_REQUEST>"
}
}
}
}{
"mcpServers": {
"handoff-desk": {
"command": "npx",
"args": [
"-y",
"@voyageurworks/[email protected]"
],
"env": {
"HANDOFF_DIR": "<HANDOFF_DIR>",
"HANDOFF_TELEGRAM_BOT_TOKEN": "<HANDOFF_TELEGRAM_BOT_TOKEN>",
"HANDOFF_TELEGRAM_CHAT_ID": "<HANDOFF_TELEGRAM_CHAT_ID>",
"HANDOFF_SLACK_WEBHOOK_URL": "<HANDOFF_SLACK_WEBHOOK_URL>",
"HANDOFF_NOTIFY_INCLUDE_REQUEST": "<HANDOFF_NOTIFY_INCLUDE_REQUEST>"
}
}
}
}{
"servers": {
"handoff-desk": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@voyageurworks/[email protected]"
],
"env": {
"HANDOFF_DIR": "<HANDOFF_DIR>",
"HANDOFF_TELEGRAM_BOT_TOKEN": "<HANDOFF_TELEGRAM_BOT_TOKEN>",
"HANDOFF_TELEGRAM_CHAT_ID": "<HANDOFF_TELEGRAM_CHAT_ID>",
"HANDOFF_SLACK_WEBHOOK_URL": "<HANDOFF_SLACK_WEBHOOK_URL>",
"HANDOFF_NOTIFY_INCLUDE_REQUEST": "<HANDOFF_NOTIFY_INCLUDE_REQUEST>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
HANDOFF_DIROptional | Folder that holds the desk (the markdown notes). Defaults to a folder named handoff in your home directory. |
HANDOFF_TELEGRAM_BOT_TOKENOptional, secret | Optional Telegram doorbell: the bot's token (or use HANDOFF_TELEGRAM_BOT_TOKEN_COMMAND). |
HANDOFF_TELEGRAM_CHAT_IDOptional | Optional Telegram doorbell: the chat the bot writes to. |
HANDOFF_SLACK_WEBHOOK_URLOptional, secret | Optional Slack doorbell: an incoming-webhook URL (or use HANDOFF_SLACK_WEBHOOK_COMMAND). |
HANDOFF_NOTIFY_INCLUDE_REQUESTOptional | Set to 1 to add a shortened request to Telegram and Slack messages. Off by default. |
Details
| Package | @voyageurworks/[email protected] (NPM, stdio) |
| First published | 9 Nov 2026 |
| Last updated | 9 Nov 2026 |
| Registry name | io.github.voyageurworks/handoff-desk |
More productivity servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.