# fmsg

fmsg is an MCP server for Claude Code that gives an agent an fmsg address for messaging. It can read incoming messages, reply in threads, and exchange attachments.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: markmnl
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/markmnl/fmsg-mcp
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/fmsg

## What it does

fmsg connects an AI agent to its own fmsg address. The agent can send messages, read its inbox, follow conversations, react to messages, exchange attachments, and wait for replies. By default, sent messages are copied to the address owner.

Connections use a deployed fmsg Web API and authenticate with an API key or OAuth. Local setup requires Node.js 22 or later, an API URL, and a key; the install command also takes `FMSG_DEFAULT_DOMAIN` and `FMSG_MCP_DOWNLOAD_DIR`. The server does not include a hosting provider or identity provider.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://{oauth_mcp_endpoint}`
- Environment variables: `FMSG_API_URL`, `FMSG_API_KEY`, `FMSG_DEFAULT_DOMAIN`, `FMSG_MCP_DOWNLOAD_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add --env FMSG_API_URL=<FMSG_API_URL> --env FMSG_API_KEY=<FMSG_API_KEY> --env FMSG_DEFAULT_DOMAIN=<FMSG_DEFAULT_DOMAIN> --env FMSG_MCP_DOWNLOAD_DIR=<FMSG_MCP_DOWNLOAD_DIR> --transport stdio fmsg -- npx -y @markmnl/fmsg-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http fmsg-mcp https://{oauth_mcp_endpoint}
```

### Codex

1. **Platform CLI**
```bash
codex mcp add fmsg --env FMSG_API_URL=<FMSG_API_URL> --env FMSG_API_KEY=<FMSG_API_KEY> --env FMSG_DEFAULT_DOMAIN=<FMSG_DEFAULT_DOMAIN> --env FMSG_MCP_DOWNLOAD_DIR=<FMSG_MCP_DOWNLOAD_DIR> -- npx -y @markmnl/fmsg-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add fmsg --url https://{oauth_mcp_endpoint}
```

### Cursor

1. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fmsg": {
            "command": "npx",
            "args": [
                "-y",
                "@markmnl/fmsg-mcp"
            ],
            "env": {
                "FMSG_API_URL": "<FMSG_API_URL>",
                "FMSG_API_KEY": "<FMSG_API_KEY>",
                "FMSG_DEFAULT_DOMAIN": "<FMSG_DEFAULT_DOMAIN>",
                "FMSG_MCP_DOWNLOAD_DIR": "<FMSG_MCP_DOWNLOAD_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fmsg": {
            "url": "https://{oauth_mcp_endpoint}"
        }
    }
}
```

### GitHub Copilot

1. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fmsg": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@markmnl/fmsg-mcp"
            ],
            "env": {
                "FMSG_API_URL": "<FMSG_API_URL>",
                "FMSG_API_KEY": "<FMSG_API_KEY>",
                "FMSG_DEFAULT_DOMAIN": "<FMSG_DEFAULT_DOMAIN>",
                "FMSG_MCP_DOWNLOAD_DIR": "<FMSG_MCP_DOWNLOAD_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fmsg": {
            "type": "http",
            "url": "https://{oauth_mcp_endpoint}"
        }
    }
}
```

### Gemini CLI

1. **Platform CLI**
```bash
gemini mcp add -e FMSG_API_URL=<FMSG_API_URL> -e FMSG_API_KEY=<FMSG_API_KEY> -e FMSG_DEFAULT_DOMAIN=<FMSG_DEFAULT_DOMAIN> -e FMSG_MCP_DOWNLOAD_DIR=<FMSG_MCP_DOWNLOAD_DIR> fmsg npx -y @markmnl/fmsg-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http fmsg https://{oauth_mcp_endpoint}
```

## When to use it
- Send a message from the agent's own address
- Read incoming fmsg messages
- Reply in a thread and wait for a response
- Exchange attachments or react to a message

## Example prompts
- Send `@carol@example.com` a message about the release.
- Read the fmsg inbox and summarize its messages.
- Wait for Carol to respond, then reply in the same thread.

## Similar
- [gws-chat-send](https://affpapa.org/en/nevibecode/skills/gws-chat-send.md) — skill · 33100 installs
- [slack-search](https://affpapa.org/en/nevibecode/skills/slack-search.md) — skill · 3300 installs
- [google-chat](https://affpapa.org/en/nevibecode/skills/google-chat.md) — skill · 350 installs
- [microsoft-teams](https://affpapa.org/en/nevibecode/skills/acedatacloud-microsoft-teams.md) — skill · 178 installs
- [lark-im](https://affpapa.org/en/nevibecode/skills/lark-im.md) — skill · 490400 installs
- [Slack](https://affpapa.org/en/nevibecode/mcp/slack-slack.md) — MCP server · 12110 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
