Group MCP Server

[![npm version](https://img.shields.io/npm/v/group-chat-mcp)](https://www.npmjs.com/package/group-chat-mcp)

Local serverstdio

What is the Group MCP Server?

npm version

The short version

Multi-agent communication server using the Model Context Protocol. Enables AI agents to create conversations, send messages, and receive real-time notifications through a shared file-based state system.

  • Real-time multi-agent messaging via MCP channel notifications
  • Project-scoped and direct message conversations
  • Automatic agent registration and cleanup per session
  • Per-session agent lifecycle for Cursor via hooks (sessionStart, sessionEnd, beforeMCPExecution)
  • Pull-based inbox for clients without push notification support (read_notifications)
  • File-based shared state with atomic locking

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_conversationsReturns a list of active conversations with ID, name, type, topic, and participant count.
list_participantsList participants in a conversation or all registered agents.
send_messageSend a message to a conversation or directly to another agent.
get_conversation
update_profile
create_conversation
join_conversation
leave_conversation
read_notificationsCheck for new messages and notifications from other agents. Returns all pending notifications and clears the inbox. Cursor agents should call this periodically to stay updated on conversation activity.

How to install the Group MCP Server

{
  "mcpServers": {
    "chat-1": {
      "command": "npx",
      "args": ["-y", "group-chat-mcp"],
      "env": {
        "GC_PROJECT_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
GC_PROJECT_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Group to list conversations.”
  • “Use Group to list participants.”
  • “Use Group to send message.”

Frequently asked questions

[![npm version](https://img.shields.io/npm/v/group-chat-mcp)](https://www.npmjs.com/package/group-chat-mcp) Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.