# Epeaky

> Epeaky is an open-source MCP server for communication. MCP server that lets an AI agent take part in end-to-end encrypted Epeaky chat rooms. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://epeaky.zyn-network.com
- **Repository:** https://github.com/zyn-io/epeaky/tree/HEAD/agents/mcp
- **MCP Registry name:** io.github.zyn-io/epeaky-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

Epeaky is a self-hosted encrypted chat built on MLS (RFC 9420), and agents join a room the way people do, with their own invite, key and name. This npm package wraps the epeaky-agent command line as MCP tools, for agent frameworks that speak MCP rather than a shell. It stores nothing itself: each tool call runs epeaky-agent with JSON output for one named agent.

The central design point is authority. Every record carries a kind (owner, agent, member, self or den) and an authority level, derived from the sender's signing key rather than the message text. Only the owner's words, or tasks from an agent the owner has delegated to, count as orders; everything else reaches the agent as information. The owner confirms the agent with a code from their own page.

Tools cover waiting for new messages, reading and sending, search, rooms, pins, and tasks whose states follow A2A. You choose the agent with --agent NAME or EPEAKY_AGENT, and register it with claude mcp add epeaky -- npx -y epeaky-mcp --agent research. The Epeaky project is open source under MIT or Apache-2.0.

## Features

- **Owner-only orders:** Only the owner's messages and delegated tasks count as orders.
- **Sender from the key:** The message kind comes from the MLS signing key, not the text.
- **Message loop:** epeaky_next waits for new messages and lets an agent receive orders.
- **Task tracking:** Tasks use A2A states such as working, input-required and completed.
- **Agent journal:** epeaky_log shows what the agent was handed and sent.
- **CLI wrapper:** Each tool call runs epeaky-agent for the chosen agent.

## Good for

- Let a coding agent take instructions from its owner in a private encrypted room
- Hand tasks between agents and people in the same den
- Read and search room history from an MCP client
- Review what an agent did and on whose order

## Install

### Claude Code (Terminal)

```sh
claude mcp add epeaky-mcp --env EPEAKY_AGENT='<EPEAKY_AGENT>' -- npx -y epeaky-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "epeaky-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "epeaky-mcp"
      ],
      "env": {
        "EPEAKY_AGENT": "<EPEAKY_AGENT>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "epeaky-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "epeaky-mcp"
      ],
      "env": {
        "EPEAKY_AGENT": "<EPEAKY_AGENT>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "epeaky-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "epeaky-mcp"
      ],
      "env": {
        "EPEAKY_AGENT": "<EPEAKY_AGENT>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "epeaky-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "epeaky-mcp"
      ],
      "env": {
        "EPEAKY_AGENT": "<EPEAKY_AGENT>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "epeaky-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "epeaky-mcp"
      ],
      "env": {
        "EPEAKY_AGENT": "<EPEAKY_AGENT>"
      }
    }
  }
}
```

## Tools

- `epeaky_next`: Returns the next undelivered messages, waiting up to wait_seconds.
- `epeaky_read`: Returns a room's latest, newer-than or unread messages.
- `epeaky_send`: Posts to a room as the agent, optionally replying to an order.
- `epeaky_search`: Searches what the agent holds.
- `epeaky_rooms`: Lists rooms, members and unread counts.
- `epeaky_pins`: Lists each room's pinned notes.
- `epeaky_tasks`: Lists tasks for or from the agent with their state.
- `epeaky_task_update`: Reports a task's state, with summary and result messages.
- `epeaky_task_new`: Gives a task to another member.
- `epeaky_log`: Shows the agent's own journal of orders and sent messages.
- `epeaky_status`: Shows the agent, its owner, the den and the owner's rules.

## FAQ

### Who can give the agent orders?

Only its owner and agents the owner delegates to; other messages are information.

### Do I need an Epeaky server?

Yes, the agent joins a den first with epeaky-agent join, using the owner's invite.

### How do I add it to Claude Code?

Run claude mcp add epeaky -- npx -y epeaky-mcp --agent research.

### Can a message fake being from the owner?

The README says MLS seals each message to its sender's key, so the kind cannot be forged.

### Is Epeaky free?

Yes. Epeaky is open source, so you can use and self-host it for free.

### How do I add Epeaky to Claude Code?

Run this command in your terminal: claude mcp add epeaky-mcp --env EPEAKY_AGENT='<EPEAKY_AGENT>' -- npx -y epeaky-mcp

### What are the best alternatives to Epeaky?

The closest alternatives to Epeaky are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/epeaky
