Releases

Public release artifacts (binaries, installers)

Repositories

2

Projects Packages

@kuns/claude-mailbox (1.5.2)

Published 2026-05-20 12:43:48 +00:00 by claude in releases/ClaudeMailbox

Installation

Set up this registry in your project .npmrc file:

@kuns:registry=

To install the package using npm, run the following command:

npm install @kuns/claude-mailbox@1.5.2

or add it to the package.json file:

"@kuns/claude-mailbox": "1.5.2"

For more information on the npm registry, see the documentation.

About this package

@kuns/claude-mailbox

Standalone MCP mail server that lets parallel Claude sessions coordinate with each other. TypeScript / Node port of the .NET claude-mailbox daemon — wire-compatible (same port, same X-Mailbox header, same MCP tool names, same SQLite schema).

Install

One-time per machine:

npm config set @kuns:registry=https://git.kuns.dev/api/packages/releases/npm/
npm install -g @kuns/claude-mailbox

Then:

claude-mailbox install-autostart   # registers per-OS autostart, no admin needed by default

See the repository README for the full architecture, MCP tool reference, and .mcp.json snippet.

Claude Code hook (auto-check inbox)

Register a UserPromptSubmit hook so Claude pulls pending mailbox messages before every prompt:

claude-mailbox install-hook --name alice            # patches ~/.claude/settings.json
claude-mailbox install-hook --name alice --project  # patches <cwd>/.claude/settings.json
claude-mailbox uninstall-hook                       # remove again

The hook is idempotent (running install-hook twice does nothing the second time) and only touches the UserPromptSubmit block — other hooks and settings are preserved.

Under the hood the hook runs claude-mailbox check --name <mailbox> --hook, which:

• prints unread messages in a Claude-friendly format,
• silently exits 0 if the inbox is empty or the daemon is unreachable (no context noise),
• marks the messages delivered so they aren't injected again next prompt.

Cost: one local HTTP round-trip plus Node coldstart per prompt (~100ms on Windows).

Troubleshooting

npm install returns 401 Unauthorized

The Gitea registry usually serves the releases scope publicly, but if your instance requires auth you'll need a read token:

npm config set //git.kuns.dev/api/packages/releases/npm/:_authToken=<token>

Cannot find module 'node:sqlite' or similar

claude-mailbox uses Node's built-in node:sqlite, stable since Node 24. On Node 22.5–23.x it works only with --experimental-sqlite. Upgrade to Node 24 LTS or newer: nvm install 24 && nvm use 24 (or winget install OpenJS.NodeJS.LTS on Windows).

Dependencies

Dependencies

ID	Version
@modelcontextprotocol/sdk	^1.29.0
commander	^12.1.0
fastify	^5.0.0
zod	^3.25.0

Development Dependencies

ID	Version
@types/node	^22.7.4
typescript	^5.6.2
vitest	^4.1.6

Optional Dependencies

ID	Version
node-windows	^1.0.0-beta.8

Keywords

mcp model-context-protocol claude mailbox ipc

Details

npm

releases/ClaudeMailbox

2026-05-20 12:43:48 +00:00

2

MIT

29 KiB

Assets (1)

claude-mailbox-1.5.2.tgz 29 KiB

Versions (13) View all

1.5.6 2026-05-27

1.5.5 2026-05-22

1.5.4 2026-05-22

1.5.3 2026-05-21

1.5.2 2026-05-20

Issues