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
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-mcpWhat 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-mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http fmsg-mcp https://{oauth_mcp_endpoint}1Platform CLI
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-mcpReplace <…> with your own values
2Platform CLI: remote server
codex mcp add fmsg --url https://{oauth_mcp_endpoint}1Config file
{
"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
2Config file
{
"mcpServers": {
"fmsg": {
"url": "https://{oauth_mcp_endpoint}"
}
}
}1Config file
{
"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
2Config file
{
"servers": {
"fmsg": {
"type": "http",
"url": "https://{oauth_mcp_endpoint}"
}
}
}1Platform CLI
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-mcpReplace <…> with your own values
2Platform CLI: remote server
gemini mcp add -t http fmsg 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.