Collected Notes
Sign in
| DEVELOPERS

Developers

Model Context Protocol

Connect AI assistants like Claude, Cursor, and other MCP-compatible tools to your Collected Notes. Read, search, create, and edit notes directly from your AI assistant.

12 tools available · API key authentication · HTTP transport

Get Started
You need an API key to connect MCP clients to your Collected Notes.

Or switch to the to manage your keys.

Available Tools

Sites
Tools for managing your sites.
list_sites

List all sites owned by you. Returns site paths, names, and metadata.

get_site

Get details of a specific site including name, headline, and custom domain.

site_path
string
required
The site path (e.g., "my-site")
Notes
Tools for reading, searching, and managing notes.
list_notes

List notes in a site. Returns paginated results with title, path, visibility, and timestamps.

site_path
string
required
The site path
page
number
Page number (default: 1)
per_page
number
Notes per page (default: 20, max: 100)
get_note

Get a specific note by its path. Returns the full note content including body, title, and metadata.

site_path
string
required
The site path
note_path
string
required
The note path/slug
search_notes

Search notes using full-text search. Searches in titles and body content.

site_path
string
required
The site path
query
string
required
Search query
page
number
Page number (default: 1)
semantic_search

Semantic search using AI embeddings. Finds notes based on meaning, not just keywords. Best for natural language queries and RAG applications.

site_path
string
required
The site path
query
string
required
Natural language query
threshold
number
Distance threshold (lower = more similar, default: 1.5)
create_note

Create a new note in a site. The path will be auto-generated from the title.

site_path
string
required
The site path
title
string
required
Note title
body
string
required
Note content (Markdown)
visibility
enum
"public", "private", or "unlisted" (default: private)
update_note

Update an existing note. Only provided fields will be updated.

site_path
string
required
The site path
note_path
string
required
The note path
title
string
New title
body
string
New content (Markdown)
visibility
enum
"public", "private", or "unlisted"
delete_note

Delete a note permanently. This action cannot be undone.

site_path
string
required
The site path
note_path
string
required
The note path to delete
Memory
Recall what you and your agents wrote, and remember what you learn.
recall

Search everything you and your agents have written, by meaning and by keyword, across every site you can read. Call this before answering questions about past work, decisions, people, or plans.

query
string
required
What to look for
limit
number
How many passages to return (default: 8)
site_path
string
Restrict the search to one site
remember

Write something worth keeping into your private Memory site. Daily notes are appended to, never rewritten.

text
string
required
What to remember
kind
string
daily, topic, decision, person, project (default: daily)
slug
string
The topic or subject this belongs to
tags
string[]
Tags for filtering
forget

Delete a note from your Memory site. Only works inside Memory.

path
string
required
The memory note path