Skip to main content

​
Memory Tools

Retrieve a list of user memories with optional filtering.Parameters:
NameTypeRequiredDescription
categoriesarrayNoCategories to filter by
limitnumberNoMaximum number of memories (default: 100)
offsetnumberNoOffset for pagination (default: 0)
Returns: { "memories": [...] }Example:
"Search my memories" → get_memories with no filters
"What do you know about my hobbies?" → get_memories with categories: ["hobbies"]
Memory categories: interesting, core, hobbies, lifestyle, interests, habits, work, skills, learnings, other
Semantic search across memories. Returns results ranked by relevance using vector similarity.Parameters:
NameTypeRequiredDescription
querystringYesNatural language search query
limitnumberNoMaximum number of results (default: 10)
Returns: { "memories": [{ ..., "relevance_score": 0.92 }, ...] }Each result includes a relevance_score (0.0 to 1.0) indicating how well it matches the query.Example:
"What do I know about machine learning?" → search_memories with query: "machine learning"
"Find memories about my morning routine" → search_memories with query: "morning routine"
Create a new memory. Category is auto-detected if not provided.Parameters:
NameTypeRequiredDescription
contentstringYesContent of the memory
categorystringNoCategory (auto-detected if omitted)
Returns: { "success": true, "memory": { ... } }
Edit an existing memory’s content.Parameters:
NameTypeRequiredDescription
memory_idstringYesID of the memory to edit
contentstringYesNew content for the memory
Returns: { "success": true }
Delete a memory by ID.Parameters:
NameTypeRequiredDescription
memory_idstringYesID of the memory to delete
Returns: { "success": true }

​
Conversation Tools

Retrieve a list of conversations with optional date and category filtering.Parameters:
NameTypeRequiredDescription
start_datestringNoFilter after this date (YYYY-MM-DD)
end_datestringNoFilter before this date (YYYY-MM-DD)
categoriesarrayNoCategories to filter by
limitnumberNoMaximum number of conversations (default: 20)
offsetnumberNoOffset for pagination (default: 0)
Returns: { "conversations": [...] } — metadata only. Use get_conversation_by_id for full transcripts.Example:
"What did I talk about last week?" → get_conversations with date range
"Show my work conversations" → get_conversations with categories: ["work"]
Conversation categories: personal, education, health, finance, technology, business, work, social, travel, entertainment, sports, family, and more.
Semantic search across conversations. Returns results ranked by relevance using vector similarity.Parameters:
NameTypeRequiredDescription
querystringYesNatural language search query
start_datestringNoFilter after this date (YYYY-MM-DD)
end_datestringNoFilter before this date (YYYY-MM-DD)
limitnumberNoMaximum number of results (default: 10)
Returns: { "conversations": [...] } — ranked by relevance to the query.Example:
"When did I discuss the product launch?" → search_conversations with query: "product launch"
"Find conversations about hiring from January" → search_conversations with query: "hiring", start_date: "2026-01-01", end_date: "2026-01-31"
Retrieve a single conversation by ID, including the full transcript with speaker segments.Parameters:
NameTypeRequiredDescription
conversation_idstringYesThe ID of the conversation
Returns: Full conversation object with transcript segments, timestamps, structured summary, and metadata.

​
Error Handling

All tools return JSON-RPC 2.0 errors when something goes wrong:
CodeMeaning
-32602Invalid parameters (bad date format, unknown category)
-32001Resource not found (memory or conversation doesn’t exist)
-32002Locked content (paid plan required)
-32601Unknown tool name
Example error response: 
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32001,
    "message": "Memory not found"
  }
}

​
Locked Content

Memories and conversations behind the paid plan are handled gracefully:
  • Memories: Content is truncated to 70 characters with ...
  • Conversations: Action items and events are hidden from the structured data
  • Direct access: Returns error -32002 with a clear message