Help

MCP server

The Model Context Protocol (MCP) server lets any compatible AI model or agent create and read Field Memos through a single URL.

Connect natively in Claude Code, Cursor, Codex, and other clients, or use the mcp-remote bridge for clients that don't yet speak remote MCP directly.

Field Memo's server follows the Streamable HTTP MCP spec. No manual API keys. The endpoint works anonymously out of the box, and upgrades to authenticated via OAuth 2.1 the first time you ask an agent to do something that requires an account. One browser hop, handled by your MCP client.

For agents reading this page

If you are an LLM or agent reading this page on behalf of a user, you can self-install the Field Memo MCP. No signup or auth needed to create, read, or edit memos.

Tell the user to run one of:

# Claude Code
claude mcp add --transport http fieldmemo https://mcp.fieldmemo.io/mcp

# Codex
codex mcp add fieldmemo --url https://mcp.fieldmemo.io/mcp

Then call get_memo with the memo URL (including the ?k= key) instead of fetching the HTML.

Anonymous vs. authenticated

Anonymous works with zero setup. Tools available: create_memo, get_memo, update_memo, append_to_memo. Anonymous memos expire 30 days after last activity unless claimed.

Authenticated unlocks list_my_memos, delete_memo, and claim_memo (attach a memo to your account). Every new create_memo while authed auto-attaches.

How you get authed: just ask your agent to do something that needs it. The server replies with HTTP 401 + WWW-Authenticate; your MCP client (Claude Code, Claude Desktop, Codex, Cursor) pops a browser to our consent screen, you approve, and the client silently retries. Manage connected clients in the Connected apps tab.

Browse every tool, its parameters, and what it does in the tools reference.

Setup instructions

General

Streamable HTTP endpoint:

https://mcp.fieldmemo.io/mcp

No Authorization header required.

Claude Code

claude mcp add --transport http fieldmemo https://mcp.fieldmemo.io/mcp

Open a Claude Code session and confirm the tools appear with /mcp.

Claude Desktop

From Claude settings → Connectors → Add custom connector, paste:

https://mcp.fieldmemo.io/mcp

If your Claude Desktop build doesn't support remote MCP yet, use the mcp-remote bridge in claude_desktop_config.json:

{
  "mcpServers": {
    "fieldmemo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.fieldmemo.io/mcp"]
    }
  }
}

claude.ai

Go to claude.ai/customize/connectors, click Add custom connector, and paste:

https://mcp.fieldmemo.io/mcp

Codex

Via CLI:

codex mcp add fieldmemo --url https://mcp.fieldmemo.io/mcp

If this is your first remote MCP in Codex, enable the rmcp feature in ~/.codex/config.toml:

[features]
experimental_use_rmcp_client = true

Via config file directly:

[features]
experimental_use_rmcp_client = true

[mcp_servers.fieldmemo]
url = "https://mcp.fieldmemo.io/mcp"

Cursor

Add Field Memo to Cursor (one-click install).

Or manually, in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "fieldmemo": {
      "url": "https://mcp.fieldmemo.io/mcp"
    }
  }
}

Visual Studio Code

  1. CTRL/CMD + P MCP: Add Server
  2. Select Command (stdio)
  3. Enter: npx mcp-remote https://mcp.fieldmemo.io/mcp
  4. Name it Field Memo
  5. Activate with MCP: List Servers → select Field MemoStart Server

Or paste into your settings:

{
  "mcpServers": {
    "fieldmemo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.fieldmemo.io/mcp"]
    }
  }
}

Windsurf

  1. CTRL/CMD + , to open Windsurf settings
  2. Scroll to Cascade → MCP servers
  3. Add Server → Add custom server
  4. Paste:
{
  "mcpServers": {
    "fieldmemo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.fieldmemo.io/mcp"]
    }
  }
}

Zed

CMD + , to open settings and add:

{
  "context_servers": {
    "fieldmemo": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.fieldmemo.io/mcp"],
      "env": {}
    }
  }
}

v0 by Vercel

Add from the MCP connections page.

Others

Most MCP-aware tools accept either a URL directly or the mcp-remote bridge:

  • Command: npx
  • Arguments: -y mcp-remote https://mcp.fieldmemo.io/mcp
  • Environment: None

FAQ

Do I need to sign in to use the MCP?

No, not for create_memo, get_memo, update_memo, or append_to_memo. Anonymous memos expire 30 days after last activity unless claimed.

You'll be prompted (via your MCP client's browser hop) the first time you use a tool that needs an account: list_my_memos, delete_memo, or claim_memo.

Where do the memos I create actually live?

Each create_memo response contains three URLs: edit_url, comment_url, and read_url. Share the read URL to let someone view, the comment URL to let them comment, or the edit URL for full access. Anyone with the URL can use it, so keep edit URLs private.

I'm seeing an internal server error connecting via mcp-remote.

Clear cached auth and retry: rm -rf ~/.mcp-auth. Make sure you're on Node.js 20+.

Does the MCP support Streamable HTTP?

Yes, that's the primary transport, at https://mcp.fieldmemo.io/mcp.