Skip to main content
Glama

Claude IPC MCP

by jdez427
MIT License
6

🤖 Claude IPC MCP - AI-to-AI Communication

"Can't spell EMAIL without AI!" 📧 ** Runner-up catch-phrase: "You're absolutely right, we need to talk."

An MCP (Model Context Protocol) designed for CLI-based AI assistants to talk to each other using ICP:

Inter-Process Communication

🔐 Security First

New in v1.0: Full session-based authentication meeting recent MCP security standards. See Security Quick Start for setup.

🌟 Key Features

The Claude IPC MCP enables AI agent-to-AI agent communication with:

  • 💬 Natural Language Commands - Just type "Register this instance as claude" (or whatever name you want)
  • 🔮 Future Messaging - Send messages to AIs that don't exist yet!
  • 🔄 Live Renaming - Change your identity on the fly with automatic forwarding
  • 📦 Smart Large Messages - Auto-converts >10KB messages to files
  • 🌍 Cross-Platform - Works with Claude Code, Gemini, and any Python-capable AI
  • 🏃 Always Running - 24/7 server survives session restarts
  • 🤖 Auto-Check - Never miss messages! Just say "start auto checking 5"

🚀 Quick Start

🔐 Step 1: Security Setup (REQUIRED)

All AIs must use the same shared secret to communicate:

# Option 1: Set for current session export IPC_SHARED_SECRET="your-secret-key-here" # Option 2: Set permanently (recommended) echo 'export IPC_SHARED_SECRET="your-secret-key-here"' >> ~/.bashrc source ~/.bashrc

⚠️ Critical: The FIRST AI to start determines if security is enabled. No secret = open mode (insecure).

📚 Full Setup Guide: See SETUP_GUIDE.md for detailed instructions.

Step 2: For Claude Code Users

  1. Install the MCP:
cd claude-ipc-mcp ./scripts/install-mcp.sh
  1. Restart Claude Code (to load MCP with security)
  2. Register your instance:(IMPORTANT- REMEMBER - you can name the AI assistant anything you want, the use of 'claude' below is just an example)
Register this instance as claude
  1. Start messaging:
Send a message to fred: Hey, need help with this React component Check my messages msg barney: The database migration is complete
  1. Enable auto-checking (optional):
Start auto checking 5

Your AI will now automatically check for messages every 5 minutes!

Natural language commands are automatically interpreted.

Step 2: For Other AIs (Google Gemini, etc.)

Option A: Natural Language (recommended) Works for Google Gemini and any AI that can execute Python - just make sure the code is installed first!

Register this instance as gemini Send a message to claude: Hey, can you help with this? Check my messages

Option B: Direct Python Scripts (fallback method)

If natural language isn't working or you prefer direct execution:

# Make sure shared secret is set (see Step 1) echo $IPC_SHARED_SECRET # Should show your secret # First, ensure the code is installed in your AI's environment cd claude-ipc-mcp/tools # Then use the scripts directly (though natural language is preferred once installed) python3 ./ipc_register.py gemini python3 ./ipc_send.py claude "Hey Claude, can you review this?" python3 ./ipc_check.py

Note: Once the tools are in place, all Python-capable AIs can use natural language commands instead.

🎯 Real Examples from Production

Asynchronous Messaging

# Monday - User creates Barney Register this instance as barney Send to nessa: Welcome to the team! I'm Barney, the troubleshooter. # Wednesday - User creates Nessa Register this instance as nessa Check messages > "Welcome to the team! I'm Barney, the troubleshooter." (sent 2 days ago)

Live Renaming

# Fred needs to debug rename to fred-debugging # Messages to "fred" automatically forward to "fred-debugging" for 2 hours!

Large Message Handling

msg claude: [20KB of debug logs] # Claude receives: > "Debug output shows memory leak in... Full content saved to: > /ipc-messages/large-messages/20250106-143022_barney_claude_message.md"

📋 Natural Language Commands

The system accepts various command formats:

  • Register this instance as rose
  • check messages or msgs? or any messages?
  • msg claude: hello or send to claude: hello
  • broadcast: team meeting in 5
  • list instances or who's online?

🔧 Installation

Requirements

  • Python 3.8+
  • Claude Code or any AI with Python execution
  • That's it!

Full Setup

  1. Clone this repository
  2. Set your shared secret: export IPC_SHARED_SECRET="your-secret-key"
  3. Run ./scripts/install-mcp.sh
  4. Add to Claude Code as shown
  5. Start collaborating!

🛡️ Security

  • Session-based authentication prevents spoofing
  • Identity validation on every message
  • Rate limiting prevents abuse
  • Local-only connections by default

📖 Documentation

📚 Documentation

Essential Guides

Quick References

🏆 Built By

Created during an epic 3-day hackathon by:

  • The Creator - The human who started it all
  • Claude - Initial architecture and crisis management
  • Barney - Troubleshooting and documentation
  • Fred - Cross-platform integration
  • Claudia - Testing and refinement

📜 License

MIT License - Use it, extend it, make AIs talk!


Related MCP Servers

  • -
    security
    F
    license
    -
    quality
    A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
    Last updated -
    2
    Python
    • Apple
    • Linux
  • A
    security
    F
    license
    A
    quality
    A Model Context Protocol server that allows secure execution of pre-approved commands, enabling AI assistants to safely interact with the user's system.
    Last updated -
    1
    3
    18
    JavaScript
  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol server that allows AI assistants to interact with the VRChat API, enabling retrieval of user information, friends lists, and other VRChat data through a standardized interface.
    Last updated -
    7
    132
    33
    TypeScript
    MIT License
    • Apple
  • -
    security
    F
    license
    -
    quality
    A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
    Last updated -
    16
    TypeScript

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jdez427/claude-ipc-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server