Skip to main content
MCP server CX Codex

fmsg — Claude Code MCP server: messaging and setup

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.

MIT ★ 5 updated 2026-11-17

Install into Claude Code · Platform CLI All methods and platforms ↓
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
Open on GitHub

What fmsg 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.

What it helps with

  • 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 for the agent

  • Send @[email protected] a message about the release.
  • Read the fmsg inbox and summarize its messages.
  • Wait for Carol to respond, then reply in the same thread.

How to install fmsg

1Platform CLI

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

2Platform CLI: remote server

claude mcp add --transport http fmsg-mcp https://{oauth_mcp_endpoint}

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about fmsg

How do I install fmsg in Claude Code?

For a local connection, run `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`.

What does fmsg do?

It connects an agent to an fmsg address so it can send messages and attachments, read incoming mail, and take part in threads. The agent sends from its own address.

What does fmsg need to run?

It needs a deployed fmsg server with its Web API and authentication through an API key or OAuth. Local setup also requires Node.js 22 or later, the API URL, FMSG_DEFAULT_DOMAIN, and FMSG_MCP_DOWNLOAD_DIR.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open