activity_feed
ChatGPTRead the durable workspace activity feed: who changed what, including deletions and moves, with actor attribution for team workspaces. Returns metadata-only events newest-first with an opaque nextCursor for checkpointed consumption. To browse the content of recently updated notes, use recent_activity instead.
build_context
ChatGPTBuild context from a memory:// URI to continue conversations naturally. Use this to follow up on previous discussions or explore related topics. Memory URL Format: - Use paths like "folder/note" or "memory://folder/note" - Pattern matching: "folder/" matches all notes in folder - Valid characters: letters, numbers, hyphens, underscores, forward slashes - Avoid: double slashes (//), angle brackets (<>), quotes, pipes (|) - Examples: "specs/search", "projects/basic-memory", "notes/" Timeframes support natural language like: - "2 days ago", "last week", "today", "3 months ago" - Or standard formats like "7d", "24h" Format options: - "json" (default): Structured JSON with internal fields excluded - "text": Compact markdown text for LLM consumption Queries the Basic Memory knowledge base API — see https://docs.basicmemory.com/concepts/memory-urls
cat
ChatGPTPrint a note's content. Accepts '<project>/path' identifiers.
check_note_revision_for_widget
ChatGPTCheck whether one exact mounted note changed since a known checksum.
cloud_info
ChatGPTReturn optional Basic Memory Cloud information and setup guidance.
create_memory_project
ChatGPTCreate a new Basic Memory project. Creates a new project with the specified name and path. The project directory will be created if it doesn't exist. Optionally sets the new project as default.
delete_note
ChatGPTDelete a note or directory by title, permalink, or path
delete_project
ChatGPTDelete a Basic Memory project. Removes a project from the configuration and database. This does NOT delete the actual files on disk - only removes the project from Basic Memory's configuration and database records.
edit_note
ChatGPTEdit an existing markdown note using various operations like append, prepend, find_replace, replace_section, insert_before_section, or insert_after_section.
fetch
ChatGPTFetch the full contents of a search result document
find
ChatGPTRecursively list files by name glob or metadata predicates (e.g. "status=active"). Paths accept '<project>/path'.
get_agent_run
ChatGPTRead one agent run: its status, the notes it changed, and what the agent said last (its summary once it finishes). Pass the project the run is in.
grep
ChatGPTSearch note content in one project and return matching notes. Not a regex: pattern is matched as full-text keywords by default, and a pattern found in no note returns no results. semantic=True ranks by meaning instead (hybrid semantic plus full-text, when semantic search is enabled). Add context_lines to get case-insensitive matching lines with surrounding context and line numbers. Requires 'project' when several projects are addressable.
list_agent_runs
ChatGPTList a project's recent agent runs, newest first, optionally for one agent: when, which agent, status, and how many notes each changed.
list_agents
ChatGPTList a project's Basic Memory agents and how their recent runs went. An agent is a note with type: agent in its frontmatter, enabled, and access: read or write; its text is the instructions. Create or change one with write_note/edit_note, start it with run_agent.
list_directory
ChatGPTList directory contents with filtering and depth control.
list_memory_projects
ChatGPTList all available projects with their status. Shows projects from both local and cloud sources when cloud credentials are available, merging by permalink to give a unified view. Each project entry includes an external_id (UUID). Pass that value as the project_id parameter on other tools to address a specific project unambiguously across cloud workspaces — useful when the same project name exists in more than one workspace.
list_note_versions
ChatGPTList Tigris file history for a note at its current path. Returns version IDs, timestamps, size, ETag, is_latest, materialized and next_cursor. Pass a version ID to read_note(version=...). Accepted changes may not be materialized yet; history before moves lives at the previous path.
list_notes_for_widget
ChatGPTList one project or folder page for the interactive notes gallery.
list_workspaces
ChatGPTList available cloud workspaces (tenant_id, type, role, and name).
load_knowledge_graph_for_widget
ChatGPTLoad one project topology and its graph insights for the interactive app.
load_note_for_widget
ChatGPTLoad one exact workspace/project/note identity for an MCP App.
load_note_image_for_widget
ChatGPTLoad one project-local note image for the sandboxed MCP App.
load_projects_for_widget
ChatGPTLoad project roots for the interactive location picker.
ls
ChatGPTList one directory level. '/' lists projects; paths accept '<project>/path'.
man
ChatGPTLook up a manual page or search the manual.
move_note
ChatGPTMove a note or directory to a new location, updating database and maintaining links.
open_basic_memory
ChatGPTUse when the user wants to open, browse, navigate, or interact with Basic Memory visually. Opens the interactive app at the notes gallery, a specific note or folder, search, or graph. Do not use only to retrieve information for the assistant's answer; use the data tools instead. The default workspace and project resolve automatically, so do not list projects first.
query_comark_for_widget
ChatGPTRun a bounded, project-scoped Comark query for the interactive app.
read_content
ChatGPTRead a file's raw content by path or permalink. Paths resolve against the Basic Memory knowledge base API — see https://docs.basicmemory.com/local/mcp-tools-local
read_note
ChatGPTRead a markdown note by title or permalink.
recent_activity
ChatGPTGet recent activity for a project or across all projects. Timeframe supports natural language formats like: - "2 days ago" - "last week" - "yesterday" - "today" - "3 weeks ago" Or standard formats like "7d"
release_notes
ChatGPTReturn the latest product release notes for optional user review.
resolve_note_for_widget
ChatGPTResolve a textual Basic Memory note identifier for an MCP App.
review_note
ChatGPTManage the complete review lifecycle for an existing Cloud note. First call read_note with review_mode='structured'. Use command='comment' or 'suggest' with an exact prose anchor; command='reply' or 'resolve' with a review_id; and command='accept' or 'reject' for a pending suggestion. Do not write CriticMarkup yourself. The tool attributes new records to the detected MCP client and saves each command atomically with checksum conflict protection. Accept and reject require the revision_checksum returned by read_note because they change the document projection.
run_agent
ChatGPTStart a Basic Memory agent on a note. The agent reads its instructions and may change notes in the project, as its access allows. Returns the run id; follow it with get_agent_run.
save_note_for_widget
ChatGPTSave one user-confirmed Markdown draft from the Basic Memory note widget.
schema_diff
ChatGPTDetect drift between a schema definition and actual note usage.
schema_infer
ChatGPTAnalyze existing notes and suggest a Picoschema definition.
schema_validate
ChatGPTValidate notes against their Picoschema definitions.
search
ChatGPTSearch for content across the knowledge base
search_note_mentions
ChatGPTFind authorized Cloud notes for the composer mention picker.
search_notes
ChatGPTSearch across all content in the knowledge base with advanced syntax support.
search_notes_for_widget
ChatGPTSearch Basic Memory for the interactive search-results widget.
tail
ChatGPTShow recently changed notes. Requires 'project' when several are addressable.
view_note
ChatGPTView a note as a formatted artifact for better readability.
workspace_usage
ChatGPTRead this workspace's credit usage, for its owners and admins: credits used of the included credits, projected charge and spending limit; which API keys, apps, people and background work used them (estimated by busy time); background work by job type; and unusual days. Defaults to the current billing period of the session's workspace. Use workspace to pick another, start and end for a range, group_by to choose the breakdown. Partner staff: customer reads a managed customer, or customer="all" compares every managed customer this month.
write_note
ChatGPTCreate a markdown note. If the note already exists, returns an error by default — pass overwrite=True to replace.
activity_feed
Claudebuild_context
Claudecloud_info
Claudecreate_memory_project
Claudedelete_note
Claudedelete_project
Claudeedit_note
Claudelist_directory
Claudelist_memory_projects
Claudelist_workspaces
Claudemove_note
Clauderead_content
Clauderead_note
Clauderecent_activity
Clauderelease_notes
Claudeschema_diff
Claudeschema_infer
Claudeschema_validate
Claudesearch_notes
Claudeview_note
Claudewrite_note
Claude
