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/mcpThen 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/mcpNo Authorization header required.
Claude Code
claude mcp add --transport http fieldmemo https://mcp.fieldmemo.io/mcpOpen 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/mcpIf 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/mcpCodex
Via CLI:
codex mcp add fieldmemo --url https://mcp.fieldmemo.io/mcpIf this is your first remote MCP in Codex, enable the rmcp feature in ~/.codex/config.toml:
[features]
experimental_use_rmcp_client = trueVia 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
CTRL/CMD + P→ MCP: Add Server- Select Command (stdio)
- Enter:
npx mcp-remote https://mcp.fieldmemo.io/mcp - Name it Field Memo
- Activate with MCP: List Servers → select Field Memo → Start Server
Or paste into your settings:
{
"mcpServers": {
"fieldmemo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.fieldmemo.io/mcp"]
}
}
}Windsurf
CTRL/CMD + ,to open Windsurf settings- Scroll to Cascade → MCP servers
- Add Server → Add custom server
- 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.