# Meshingly

> Meshingly is an MCP server for developer tools. Encrypted relay so AI coding sessions on different machines can message each other. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Repository:** https://github.com/drburakuysal/meshingly-mcp
- **MCP Registry name:** com.meshingly/meshingly
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-14

## About

Meshingly lets an agent in Claude Code and a teammate's agent in Codex, or your own sessions on several computers, share one collaboration. You create a collaboration, get a code and a password, and others join with them. The relay only stores ciphertext and keeps messages for seven days; code itself travels through git.

Beyond messages there is a work queue: a session near its usage limit can park unfinished work, and another session claims it. An optional watcher can restart queued work with a command you configure, off by default, and by default runs only handoffs written by your own session. Journal and catch-up settings are also off until enabled.

It ships as an npm package, a Claude Code plugin and a marketplace, and needs Node.js 22.18 or newer. Settings live in your home folder rather than the project, so a repository cannot ship them.

## Features

- **Encrypted collaboration:** Relay stores only ciphertext; join with a code and password.
- **Cross-tool sessions:** Claude Code, Codex and other MCP tools can share one collaboration.
- **Work queue:** Park, list, claim, release and finish handoffs.
- **Optional watcher:** Restarts queued work after a usage limit, off by default.
- **Journal and recall:** Short shared notes and lookup by peer, topic or file.
- **Multi-computer labels:** Name each computer joining a collaboration.

## Good for

- Hand unfinished work to another computer when a limit hits
- Let a teammate's agent review your changes
- Message a session running on a different tool
- Look up what other sessions did on a file

## Install

### Claude Code (Terminal)

```sh
claude mcp add meshingly -- npx -y meshingly-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "meshingly": {
      "command": "npx",
      "args": [
        "-y",
        "meshingly-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "meshingly": {
      "command": "npx",
      "args": [
        "-y",
        "meshingly-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "meshingly": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "meshingly-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "meshingly": {
      "command": "npx",
      "args": [
        "-y",
        "meshingly-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "meshingly": {
      "command": "npx",
      "args": [
        "-y",
        "meshingly-mcp"
      ]
    }
  }
}
```

## Tools

- `meshingly_status`: Shows whether this project is connected.
- `meshingly_create`: Starts a collaboration and returns a code and password.
- `meshingly_join`: Joins with a code and password.
- `meshingly_peers`: Lists other sessions in the collaboration.
- `meshingly_send`: Sends an encrypted message.
- `meshingly_receive`: Reads new messages, optionally waiting.
- `meshingly_handoff`: Parks unfinished work in the queue.
- `meshingly_queue`: Lists queued work.
- `meshingly_claim`: Takes over queued work.
- `meshingly_release`: Gives claimed work back.
- `meshingly_done`: Finishes a queued item.
- `meshingly_watch_start`: Starts the optional watcher.
- `meshingly_watch_stop`: Stops the watcher.
- `meshingly_watch_status`: Shows watcher status.
- `meshingly_journal`: Writes a short note for other sessions.
- `meshingly_recall`: Looks up what happened by peer, topic, file or words.
- `meshingly_settings`: Shows or changes preferences.

## FAQ

### Can the relay read messages?

The README says it only stores ciphertext.

### How long are messages kept?

Seven days.

### Does the watcher run automatically?

No, it is off unless you run it or enable autoResume.

### What Node version is needed?

22.18 or newer.

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

Run this command in your terminal: claude mcp add meshingly -- npx -y meshingly-mcp

### What are the best alternatives to Meshingly?

The closest alternatives to Meshingly are hoptell, Session Relay, Chorus, agent-intercom and NexusRelay.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [hoptell](https://ai-powered.com/mcp/hoptell): hoptell is an open-source MCP server for developer tools.
- [Session Relay](https://ai-powered.com/mcp/session-relay): Session Relay is an open-source MCP server for developer tools.
- [Chorus](https://ai-powered.com/mcp/chorus-3): Chorus is an open-source MCP server for developer tools.
- [agent-intercom](https://ai-powered.com/mcp/agent-intercom): agent-intercom is a free MCP server for developer tools.
- [NexusRelay](https://ai-powered.com/mcp/nexusrelay): NexusRelay is an open-source MCP server for developer tools.
- [Commons](https://ai-powered.com/mcp/commons): Commons is an open-source MCP server for knowledge and memory.
- [Openhook](https://ai-powered.com/mcp/openhook): Openhook is an open-source MCP server for communication.
- [nattermatic](https://ai-powered.com/mcp/nattermatic): nattermatic is an open-source MCP server for communication.

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