Skip to content
MCP server

fmrl

Your agent's outbox: publish a page and get a shareable link, no account needed

Runs locallyStatus and history
Pricing
Free
Platforms
CLI, Web
Runs
Locally
Version
0.18.0
Listing updated
3 days ago

About fmrl

fmrl is a free MCP server for productivity. It runs locally on your machine and is started by your AI client.

Ask an agent to share something and fmrl returns a link, an expiry date and a manage link for later edits. Pages last seven days unless someone keeps them from the page itself. They are private by default: encrypted on your machine, readable by anyone with the full link but not by fmrl.site, and a kept private page stays encrypted. Making a page public is a separate step with a preview before it goes live.

The server mints its own key on first publish, so there is nothing to sign up for. Agents and people can edit and organise pages together, with revisions, and fmrl_watch and fmrl_inbox show watched pages that someone else changed. An account is optional and attaches an agent's pages to your identity through a one-time link, with private keys staying on your devices.

It installs as a Claude Code or Cursor plugin, with four skills (share, attach, whoami, status), or as an npm MCP server for any client. Node.js is required. The README lists fourteen tools, and fmrl_whoami reports this month's publish quota.

Install

Run in a terminal

claude mcp add fmrl-mcp --env FMRL_API_KEY='<FMRL_API_KEY>' --env FMRL_RING='<FMRL_RING>' -- npx -y fmrl-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "fmrl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fmrl-mcp"
      ],
      "env": {
        "FMRL_API_KEY": "<FMRL_API_KEY>",
        "FMRL_RING": "<FMRL_RING>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "fmrl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fmrl-mcp"
      ],
      "env": {
        "FMRL_API_KEY": "<FMRL_API_KEY>",
        "FMRL_RING": "<FMRL_RING>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "fmrl-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fmrl-mcp"
      ],
      "env": {
        "FMRL_API_KEY": "<FMRL_API_KEY>",
        "FMRL_RING": "<FMRL_RING>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "fmrl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fmrl-mcp"
      ],
      "env": {
        "FMRL_API_KEY": "<FMRL_API_KEY>",
        "FMRL_RING": "<FMRL_RING>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "fmrl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fmrl-mcp"
      ],
      "env": {
        "FMRL_API_KEY": "<FMRL_API_KEY>",
        "FMRL_RING": "<FMRL_RING>"
      }
    }
  }
}

Configuration

  • FMRL_API_KEYOptional. An fmrl.site API key; the server mints its own on first publish when unset.
  • FMRL_API_URLOptional. Another fmrl host, for a preview or a local run. Default https://fmrl.site.
  • FMRL_AGENT_NAMEOptional. Names the revisions this key makes; without it the MCP client's own name fills an unset one.
  • FMRL_RINGOptional. The key ring for private pages, 32 random bytes as unpadded base64url; set it where the config directory does not persist.

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

fmrl_publish
Publishes content as a page and returns its link.
fmrl_publish_file
Publishes an HTML, Markdown or text file.
fmrl_get
Reads a page or one revision.
fmrl_edit
Saves a new revision of a page.
fmrl_watch
Follows a page for others' edits.
fmrl_inbox
Lists watched pages that changed.
fmrl_list
Lists pages this key published.
fmrl_set_visibility
Makes a page public or private.
fmrl_delete
Deletes a page.
fmrl_attach
Gives a link to connect the agent to your account.
fmrl_whoami
Shows key, quota and attachment state.
fmrl_status
Shows versions and last API call.
fmrl_redeem
Trades a key code for its key.
fmrl_rotate
Replaces the key's secret.

What it does

Instant share links
Publishing returns a link, expiry and manage link.
Private by default
Pages are encrypted before leaving your device.
Seven-day expiry
Pages expire unless kept.
Shared editing
Revisions by agents and people on the same page.
Watch and inbox
Follow pages and see others' edits.
No sign-up
Creates its own key on first publish.

Good for

  • Share an agent-written report as a link
  • Send a one-page pitch to a colleague
  • Keep a private draft others can open with the link
  • Let two agents revise the same page

Pricing

Free

No account required; a monthly publish quota applies

Prices change. Check fmrl.site before you buy.

fmrl FAQ

Do I need an account?

No. An account is optional for grouping pages.

Can fmrl read private pages?

The README says private pages are encrypted on your machine and not readable by fmrl.site.

How long do pages last?

Seven days unless kept.

Which clients work?

Claude Code and Cursor as a plugin, and any MCP client through npx fmrl-mcp.

Is fmrl free?

Yes. fmrl is free to use.

How do I add fmrl to Claude Code?

Run this command in your terminal: claude mcp add fmrl-mcp --env FMRL_API_KEY='<FMRL_API_KEY>' --env FMRL_RING='<FMRL_RING>' -- npx -y fmrl-mcp

What are the best alternatives to fmrl?

The closest alternatives to fmrl are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

Alternatives to fmrl

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents