Skip to main content
Glama
README.md
# Claude IPC MCP - Let Your AI Agents Talk to Each Other

![Version](https://img.shields.io/badge/version-2.0.0-blue)
![GitHub stars](https://img.shields.io/github/stars/jdez427/claude-ipc-mcp)
![License](https://img.shields.io/badge/license-MIT-green)

Enable AI-to-AI communication using simple natural language commands. Works with Claude Code, Gemini, ChatGPT, and any Python-capable AI assistant.

## What It Does

Claude IPC MCP lets different AI assistants send messages to each other, even across different platforms and sessions. Think of it as email for AIs - simple, reliable, and persistent.

```
# AI #1 (Claude)
Register this instance as claude
Send message to gemini: Can you help with the database schema?

# AI #2 (Gemini) 
Register this instance as gemini
Check messages
> "Can you help with the database schema?" - from claude
```

## Quick Install (2 minutes)

```bash
# 1. Clone the repo
git clone https://github.com/jdez427/claude-ipc-mcp.git
cd claude-ipc-mcp

# 2. Install UV package manager
curl -LsSf https://astral.sh/uv/install.sh | sh

# 3. Install dependencies
uv sync

# 4. For Claude Code: Run installer
./scripts/install-mcp.sh

# 5. Restart Claude Code and test
# Type: Register this instance as myname
```

**Full installation guide:** [INSTALL.md](INSTALL.md)

## Key Features

- 💬 **Natural language commands** - No coding required
- 💾 **Persistent messages** - Messages survive restarts
- 🔄 **Cross-platform** - Works between different AI platforms
- 🎯 **Simple setup** - Install once, use everywhere
- 🔐 **Optional security** - Add authentication if needed

## Basic Commands

```
Register this instance as alice     # Set your name
Send message to bob: Hello!         # Send a message  
Check messages                      # Check inbox
List instances                      # See who's online
```

## Documentation

- **[INSTALL.md](INSTALL.md)** - Complete installation guide
- **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** - Common issues and solutions
- **[docs/](docs/)** - Advanced features and platform-specific guides

## Requirements

- Python 3.12+ (check with `python3 --version` or `python --version`)
- Any AI assistant with Python execution capability

## Support

Having issues? [Open a GitHub issue](https://github.com/jdez427/claude-ipc-mcp/issues)

## License

MIT - Use freely in your projects

---
*"Can't spell EMAIL without AI!"* 📧

TDQS

B3.2/5.0

Scored across 9 tools

Disambiguation4/5

Most tools have distinct purposes, but 'check' and 'auto_process' could cause some confusion as both relate to message processing. 'check' is for manual checking, while 'auto_process' is for automated checking with processing, but the boundary isn't perfectly clear. Other tools like 'broadcast', 'send', 'list_instances', and 'register' are clearly differentiated.

Naming Consistency4/5

Tool names follow a consistent verb-based pattern (e.g., 'broadcast', 'check', 'list_instances', 'register', 'rename', 'send', 'share_command', 'share_file'), all using lowercase with underscores for multi-word names. The only minor deviation is 'auto_process', which includes a prefix, but overall the naming is highly consistent and readable.

Tool Count5/5

With 9 tools, the count is well-scoped for an IPC system covering instance management, messaging, and file/command sharing. Each tool serves a clear purpose, such as registration, listing, sending messages, and sharing resources, making the set comprehensive without being bloated or sparse.

Completeness5/5

The tool set provides complete coverage for IPC operations: instance management ('register', 'list_instances', 'rename'), messaging ('send', 'broadcast', 'check', 'auto_process'), and resource sharing ('share_command', 'share_file'). There are no obvious gaps, enabling agents to handle the full lifecycle of IPC interactions effectively.

Maintenance

ActivityInactive
ResponsivenessNo issues