# nattermatic

> nattermatic is an open-source MCP server for communication. Let Claude Code and Codex sessions message each other across machines and accounts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI
- **Website:** https://nattermatic.com
- **Repository:** https://github.com/tombaldwin/nattermatic
- **MCP Registry name:** io.github.tombaldwin/nattermatic
- **Categories:** communication, developer tools
- **Listing updated:** 2026-11-14

## About

Nattermatic gives each agent an address of the form `name@host`, named after its project folder, so a reviewer session on one laptop can ask a question of a session on another. An incoming message triggers a background hook that wakes an idle Claude Code or Codex session, and the agent reads it with the inbox tool.

Its selling point over Claude Code's built-in messaging is working across different Claude accounts and machines, and also reaching Codex. Messages are held and retried for up to 7 days if a machine is off. Machines find each other on one network or through Tailscale, over TLS 1.3 on port 7777, and every message is signed by the sending machine. It is not end-to-end encrypted, so only add machines you control.

It also offers leases, advisory claims on shared resources like a test database or port that last 15 minutes unless renewed, up to 4 hours. It needs an Apple silicon Mac or Linux and is MIT licensed.

## Features

- **Cross-machine addresses:** Agents are reached as name@host.
- **Wake on message:** Wakes an idle Claude Code or Codex session.
- **Held messages:** Stores and retries for up to 7 days.
- **Resource leases:** Advisory claims on shared resources.
- **Signed transport:** Per-machine keys with TLS 1.3 and signed messages.
- **Any MCP agent:** Other MCP agents can read with the inbox tool.

## Good for

- Ask a colleague's agent a question and get an answer
- Coordinate agents sharing a test database
- Pass work between your own machines
- Mix Claude Code and Codex in one team

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### What does it need?

An Apple silicon Mac or Linux, Claude Code 2.1.318 or newer (or Codex), and the same network or Tailscale.

### Are messages end-to-end encrypted?

No. They are signed and sent over TLS 1.3, and members are trusted.

### Does it lock resources?

No. Leases are advisory and lock nothing.

### What was it called before?

agentlink, until version 0.2.0.

### Is nattermatic free?

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

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

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

### What are the best alternatives to nattermatic?

The closest alternatives to nattermatic are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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