claude-mail-bridge

Claude Mail Bridge is an email-powered remote control for Claude Code. It lets you manage Claude Code running in your terminal from anywhere by sending and receiving commands via email. The system captures session context, such as project, branch, working directory, and start time, and supports attaching files up to 15MB. You can remotely approve permissions, influence Claude's AI behavior through a three-layer setup (MCP Tools, Skills, and Hooks), and coordinate team actions via the built-in team management tools. To get started, install the package, configure SMTP and recipient settings, install the Claude Code plugin, and then run the daemon. Once running, you can use presence commands to set your status, trigger remote control phrases to switch between online and away, and issue email-based commands to have Claude summarize progress, notify teammates, or fetch results via email.

Prerequisites:

• Python 3.8+ and pip
• Internet access to install packages

1. Install the package (via PyPI):

pip install claude-mail-bridge

2. Optional: build/install from source

# Clone the repository
git clone https://github.com/CodingJay-1/claude-mail-bridge.git
cd claude-mail-bridge

# Build the package (if needed)
pip install build
python -m build

# Install the built wheel
pip install dist/claude_mail_bridge-*.whl

3. Set environment variable for SMTP password (recommended):

# Add to your shell profile
export CMB_SMTP_PASSWORD='your_smtp_password'

4. Run the setup wizard to configure accounts and recipient details:

claude-mail-bridge setup

5. Install the Claude Code plugin (which wires MCP, hooks, and skills):

claude-mail-bridge install-claude-plugin

6. Start the daemon:

claude-mail-bridge start

Tips and considerations:

• The SMTP password is stored in environment variables for security; never hard-code credentials.
• Configuration is saved at ~/.claude-mail-bridge/config.json. Back it up if needed.
• The MCP tools exposed include presence, email, and team management capabilities. Skills and hooks auto-enable based on context and user commands.
• To stop or check status, use claude-mail-bridge stop or claude-mail-bridge status.
• Attaching files larger than 15MB is not supported; consider compressing attachments or using links.
• If you modify network or email provider settings, re-run claude-mail-bridge setup to refresh config.