# fmrl

> fmrl is a free MCP server for productivity. Your agent's outbox: publish a page and get a shareable link, no account needed. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, Web
- **Website:** https://fmrl.site/install
- **Repository:** https://github.com/toogreatwtf/fmrl-plugin/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.toogreatwtf/fmrl-mcp
- **Categories:** productivity, files and documents
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

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