How to use Forgetwell MCP?

This is the official guide to connecting an AI assistant to Forgetwell over MCP. Setup takes about two minutes; everything below is copy-pasteable.

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants — Claude, Codex, and most modern agents — securely connect to outside tools and data. Think of it as a USB port for AI: once a service exposes an MCP server, any MCP-capable assistant can plug into it. You stay in control: the connection is authorized by you, with your account, and you can revoke it any time.

What can Forgetwell MCP do?

It gives your assistant your second memory:

• Recall: search your notes by exact words in any language, plus semantic similarity — a search for car also surfaces the note that says vehicle. (Similarity works at the level of search terms; it's not question-answering — see the examples below for what to expect.)
• Capture: create notes mid-conversation — "save this summary to my Forgetwell"
• Organize (optional): list/rename tags, set note colors, restore from trash

Deletion is disabled on the server — the assistant can send notes to trash, and you can always restore. Everything runs over OAuth 2.1: you sign in with your own Forgetwell account in the browser, and the assistant only ever acts as you.

Install in Claude Code

claude mcp add --transport http forgetwell https://mcp.forgetwell.com/mcp

Then inside a session run /mcp and pick forgetwell to authenticate — a browser window opens, sign in with your Forgetwell account, done. (On claude.ai or Claude Desktop: Settings → Connectors → Add custom connector → paste the same URL.)

Install in Codex

Add to ~/.codex/config.toml:

[mcp_servers.forgetwell]
url = "https://mcp.forgetwell.com/mcp"

Then run codex mcp login forgetwell to complete the OAuth sign-in. On older Codex versions, remote servers also need experimental_use_rmcp_client = true at the top of the config; if yours predates streamable-HTTP support entirely, bridge it with command = "npx", args = ["-y", "mcp-remote", "https://mcp.forgetwell.com/mcp"].

What it looks like in practice

• "Search my Forgetwell for car." → forgetwell_search_notes runs hybrid search: exact matches first, plus semantically similar notes — the one where you only wrote vehicle shows up too. Works across languages: searching doctor can surface a note that says 医生.
• "Investigate the issues in my latest Forgetwell note tagged #debug." → the assistant pulls your newest #debug note, reads the stack trace or repro steps you captured there, and gets to work on your codebase. Jot problems into Forgetwell as you hit them; your coding agent picks them up later.
• "Summarize today's debugging session and save it to Forgetwell tagged postmortem." → forgetwell_create_note, tags created automatically.
• "What tags do I have around cooking? Merge the duplicates." → forgetwell_list_tags + forgetwell_rename_tag.
• "Mark that note red, it's urgent." → forgetwell_set_note_color.

One expectation to set: search matches words and meanings of words, not questions. Ask your assistant to search for insurance renewal, not "when is my insurance due?" — the assistant is usually smart enough to pick good search terms itself, but short noun phrases recall best.

Full tool list: create/get/update/search notes, tags (list, autocomplete, rename, approve), note colors, trash + restore, and settings. Questions or bugs — reply here.