MCP Tools

The tools memex exposes to Claude via the Model Context Protocol.

When you connect memex to Claude, it gets access to 8 tools. Claude uses these automatically — you don't have to ask.

Tools

ToolDescription
save_noteSave a note. Warns if a semantically similar note already exists.
search_notesHybrid semantic search with optional filters.
list_notesList recent notes by creation date.
list_tagsAll tags with note counts.
list_foldersAll folders with note counts.
get_noteFull note content + backlinks by ID.
update_noteUpdate title, content, or tags of an existing note.
delete_noteDelete a note by ID.

search_notes parameters

ParameterTypeDescription
querystringThe search query (natural language)
limitnumberMax results (default 10)
categorystringFilter to a specific folder
tagstringFilter by tag
date_fromstringISO 8601 date — only notes on or after this date
date_tostringISO 8601 date — only notes on or before this date

Example: "What did we decide about auth last April?" → Claude calls search_notes with query="auth decision", date_from="2025-04-01", date_to="2025-04-30".

save_note behavior

Before saving, Claude is instructed to:

  1. Call list_tags and list_folders to see existing taxonomy
  2. Pick from existing tags/folders rather than inventing new ones
  3. Use [[Title]] wiki-link syntax for references to people, projects, or concepts

If save_note returns a ⚠️ similar notes warning, Claude switches to update_note on the most relevant existing note instead of creating a duplicate.

get_note returns the full note content and a "Referenced by" section listing every note that links to this one via [[Title]] syntax. Backlinks are resolved at save/update time.

Claude's automatic behavior

Claude is configured to:

  • Always search before answering any question that might relate to past conversations, decisions, or projects
  • Save at end of conversation when technical decisions were made, key insights emerged, or you explicitly said "remember this"
  • Prefer update over save when new content belongs with an existing note