Releases

Public release artifacts (binaries, installers)

Repositories

2

Projects Packages

@kuns/claude-mailbox (1.1.0)

Published 2026-05-19 11:57:41 +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.1.0

or add it to the package.json file:

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

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>

gyp ERR! find VS on Windows during install

better-sqlite3 ships prebuilt binaries for current Node LTS versions. If yours isn't covered, npm falls back to building from source and needs the Visual Studio Build Tools. Either install them or pin to a Node version with a matching prebuild.

Dependencies

Dependencies

ID	Version
@modelcontextprotocol/sdk	^1.29.0
better-sqlite3	^11.3.0
commander	^12.1.0
fastify	^5.0.0
zod	^3.25.0

Development Dependencies

ID	Version
@types/better-sqlite3	^7.6.11
@types/node	^22.7.4
typescript	^5.6.2
vitest	^2.1.1

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-19 11:57:41 +00:00

1

MIT

25 KiB

Assets (1)

claude-mailbox-1.1.0.tgz 25 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