{"format":"verfy.mcp-server/1","page":"https://verfy.dev/servers/basic-memory","collectedAt":"2026-11-13","server":{"id":"basic-memory","eco":"pypi","pkg":"basic-memory","releases":[{"version":"0.23.0","published":"2026-08-24","started":true},{"version":"0.23.1","published":"2026-08-25","started":true},{"version":"0.23.2","published":"2026-08-25","started":true},{"version":"0.24.0","published":"2026-10-23","started":false},{"version":"0.24.1","published":"2026-10-23","started":true},{"version":"1.0.0","published":"2026-10-29","started":true}],"tools":[{"name":"bm_context","pin":"sha256:4f8bdffa1af3c2d9bc775e0080a08c6774afc3d7aaed6d60ffb7eb1228ca7f61","description":"Follow the Basic Memory knowledge graph from a note: the note, its observations, and the notes its relations reach, up to `depth` hops (1-5). `identifier` is a path, permalink, memory:// URL, or a pattern such as 'specs/*'. `since` limits related results to recent changes. `compact` returns the graph without note bodies; read chosen notes with bm_read."},{"name":"bm_delete","pin":"sha256:0659be41777115cf0476e3f54058155ab5e869a8672f832ed1a4643e7d3b1970","description":"Delete a Basic Memory note (`identifier`) or a directory (`path`). A directory delete removes every file under it and needs `recursive=true`. Pass `expected_checksum` (from bm_read) to delete a note only if it is still the revision you read. A note that does not exist is an error. This cannot be undone."},{"name":"bm_edit","pin":"sha256:3d56f1c880f6b0f5c926e160a7514bbc4942c2afc48b1c29d03b3450759ceb36","description":"Change part of an existing Basic Memory note. `command`: append or prepend `content`; find_replace `find_text` with `content` (exact text, which must occur `expected_replacements` times, default 1); replace_section, insert_before_section or insert_after_section for a `section` heading ('Decisions', 'Auth/Decisions', 'Decisions[1]', as bm_read takes it); set_metadata to merge `metadata` into the frontmatter without touching the body. `metadata` also merges with any other command. Pass `expected_checksum` (from bm_read) to edit only the revision you read. A missing note is an error; create notes with bm_write."},{"name":"bm_find","pin":"sha256:ebd360ab756743f6ccb8174aaf5a041f22940bef8f2a8e176058e273e7e4b93b","description":"Find files in a Basic Memory project, recursively. With `name`, match file names against a glob ('*meeting*'). With `filters`, match notes by frontmatter, e.g. {\"status\": \"active\"} or {\"priority\": {\"$in\": [\"high\"]}}, and with `fields` return just those frontmatter values per note. `path` limits the search to a folder. For ranked text or meaning search, use bm_search."},{"name":"bm_list","pin":"sha256:db5d85cfab8fd2d666719f61bb4adf3dd8dbb81b8653c64559328a4ece17187f","description":"List one folder of a Basic Memory project: its subfolders, then its files with title, date and id. `project` is required; '/' lists its root. Discover projects with bm_project(command='list'). Filter files with `glob` and order them with `sort`. For a recursive search by name or frontmatter, use bm_find."},{"name":"bm_man","pin":"sha256:34aa3f3c0076058ca802e415b353c9676156edb86b76f1a60c0bda0a217ec91f","description":"Read the Basic Memory manual. With no arguments, the index of every page. `page` reads one page: 'bm-search(3)' for an MCP tool, 'grep(1)' for a shell command; a tool name such as 'bm_search' works too. `query` lists the pages that mention every word given, like `man -k`."},{"name":"bm_move","pin":"sha256:9b3d0dae8ee89ba31e909f10499adf1b24081778db834037cb47416dea672c1d","description":"Move or rename a Basic Memory note (`identifier`) or a directory (`path`) within its project. `destination` is the new project-relative path; ending it with '/' moves into that folder under the current name ('archive/'). A note keeps its file extension ('.markdown' may become '.md'). Pass `expected_checksum` (from bm_read) to move a note only if it is still the revision you read. Moving into another project is refused: bm_read, bm_write there, then bm_delete."},{"name":"bm_schema","pin":"sha256:bba7bddda3c7f5675751d2ad70658d1567cd6de8728fd2bde590fb6b5864d2fc","description":"Basic Memory note schemas (Picoschema). `command`: validate notes against their schema (one `note_type`, one note by `identifier`, or every type that has a schema); infer a schema from the notes of a `note_type`; diff a `note_type`'s notes against its schema to find drift. A schema is a note with type: schema whose `entity` field names the note type it describes."},{"name":"bm_project","pin":"sha256:c4509e9fdf7eb560e9e7cfad7b327f427fbba6ae54f6a538ec707a6852f6fc8a","description":"Basic Memory projects. `command`: list (projects, grouped by workspace); create (`name`, `path`, optional `set_default`, `workspace`); recent (what changed lately in the required `project`: `since`, `items`, paging)."},{"name":"bm_search","pin":"sha256:8e24d4aec7cbcd9f0c791f53aefd4c8ea6aafcbf73d641abb7169f3a20fec0aa","description":"Search a Basic Memory project, ranked by relevance. `query` supports quoted phrases, AND/OR/NOT and tag:name. `mode` picks hybrid (the default when semantic search is available), text, semantic, title or permalink (globs with *). Narrow with `filters` (frontmatter), `note_types`, `items` (notes, observations, relations) and `since`. `lines` returns the matching lines of each hit with that many lines of context, like grep. `path` limits the search to a folder; `identifier` searches one note. Scope every search with `project` (one project), `projects` (a list), or `all_projects=true`. Read full notes with bm_read."},{"name":"bm_read","pin":"sha256:c03a4928ba0598c73280beb9bd213754c3021fa0d262c1ecab50ba9ffa72b3eb","description":"Read a Basic Memory note or file by path, permalink, memory:// URL or exact title. Slice a long note with `section` (a heading), `start_line`/`end_line` or `max_tokens`; line numbers count the whole file, frontmatter included. A text file such as .txt takes start_line/end_line too. `include_content=false` returns only the metadata and the checksum that bm_write and bm_edit take as expected_checksum. Images come back as images and other binary files as documents. A missing note is an error: find notes with bm_search."},{"name":"bm_write","pin":"sha256:235ce304b39946dbef71a0933d642b6427af5269ad681b555e1b161d1a81fe05","description":"Create or replace a Basic Memory note. Give a file path as `identifier` ('notes/plan.md'), or `title` plus `directory`. With a path the file lands exactly there and the title comes from the content's frontmatter, then `title`, then the file name. An existing note is an error unless `overwrite=true`; pass `expected_checksum` (from bm_read) to replace only the revision you read. To change part of a note use bm_edit. Content may hold frontmatter, observations ('- [category] fact #tag') and relations ('- relation_type [[Other Note]]')."},{"name":"prompt:continue_conversation","pin":"sha256:52eacdc83e58052e5060842de465c2e1cc6ce3183523e0e549cc829a8aaf7a61","description":"Continue a previous conversation"},{"name":"prompt:getting_started","pin":"sha256:a2e170f20c782965581190674679fa56b843a0bb379d7b59262701b0514aa6cc","description":"Introduce Basic Memory and help the user create their first note"},{"name":"prompt:recent_activity","pin":"sha256:f52610da469634b5a03f4032fb0d6b0a3c1482c3f0fbf2b51d0b3781f069323d","description":"Get recent activity from the given or configured default project. Discover projects first when neither resolves."},{"name":"prompt:search_knowledge_base","pin":"sha256:ca7c1960888cec8e18029ddb299e9ecbedf28a45a6b3838a70f806c9e583a76d","description":"Search across all content in basic-memory"}],"updates":[{"from":"0.23.0","to":"0.23.1","published":"2026-08-25","bump":"patch","added":[],"removed":[],"changed":[]},{"from":"0.23.1","to":"0.23.2","published":"2026-08-25","bump":"patch","added":[],"removed":[],"changed":[]},{"from":"0.23.2","to":"0.24.1","published":"2026-10-23","bump":"minor","added":["cat","find","grep","ls","man","tail"],"removed":[],"changed":[{"tool":"basic_memory_diagnostics","description":true,"schema":false,"before":"Return version, system, and configuration diagnostics for Basic Memory.\n\nProvides:\n- Basic Memory package version\n- Python version and platform details\n- Config file path and its contents (secrets redacted)\n\nUseful for troubleshooting installations and gathering information for\nsupport requests. Read-only; never emits secrets or API keys.","after":"Return version, system, and configuration diagnostics for Basic Memory.\n\nProvides:\n- Basic Memory package version\n- Python version and platform details\n- Config file path and its contents (secrets redacted)\n- BASIC_MEMORY_* environment variables that override the file at runtime\n\nUseful for troubleshooting installations and gathering information for\nsupport requests. Read-only; never emits secrets or API keys."},{"tool":"build_context","description":false,"schema":true,"propsAdded":["compact"],"propsRemoved":[]},{"tool":"create_memory_project","description":false,"schema":true,"propsAdded":[],"propsRemoved":[]},{"tool":"delete_note","description":true,"schema":true,"before":"Delete a note or directory by title, permalink, or path","after":"Delete a note or directory by title, permalink, or path. Deletion is permanent and removes the file. With is_directory=True every file under the path is deleted. A missing note returns false rather than an error.","propsAdded":[],"propsRemoved":[]},{"tool":"delete_project","description":true,"schema":true,"before":"Delete a Basic Memory project.\n\nRemoves a project from Basic Memory's configuration and database records.\nBy default the project's note files are retained: local projects keep\ntheir files on disk, cloud projects keep their files in cloud storage.\nPass delete_notes=True to also delete the note files themselves.","after":"Delete a Basic Memory project.\n\nRemoves a project from Basic Memory's configuration and database records.\nLocal projects keep their note files on disk unless delete_notes=True.\nCloud projects always have their note files deleted from cloud storage;\nthose files can be recovered only from a cloud snapshot.","propsAdded":[],"propsRemoved":[]},{"tool":"edit_note","description":true,"schema":true,"before":"Edit an existing markdown note using various operations like append, prepend, find_replace, replace_section, insert_before_section, or insert_after_section. Pass metadata to merge YAML frontmatter fields independent of the operation.","after":"Edit a note in place. `operation` picks the edit: append or prepend `content` (prepend lands after frontmatter; both create the note if it does not exist); find_replace (replaces every exact, case-sensitive occurrence of `find_text`, and writes nothing unless the count equals `expected_replacements`, default 1); replace_section (replaces the content under the `section` heading, including its subsections unless replace_subsections=false); insert_before_section / insert_after_section (adds content beside the `section` heading). The heading must match exactly and appear once; a heading without leading `#` is treated as `##`. A missing or duplicate heading, or missing find_text, fails without writing. `identifier` must resolve exactly; there is no fuzzy matching. Pass `metadata` to merge frontmatter fields in the same call. Pass `expected_checksum` to edit only if the note is still the revision you read.","propsAdded":["expected_checksum"],"propsRemoved":[]},{"tool":"fetch","description":true,"schema":false,"before":"Fetch the full contents of a search result document","after":"OpenAI/ChatGPT connector fetch adapter. Takes an id from search results (permalink, title, or memory:// URL) and returns one text item holding JSON {id, title, text, url, metadata}. Other MCP clients receive an unsupported-client error; use read_note instead."},{"tool":"list_memory_projects","description":false,"schema":true,"propsAdded":[],"propsRemoved":[]},{"tool":"move_note","description":true,"schema":true,"before":"Move a note or directory to a new location, updating database and maintaining links.","after":"Move a note, or a whole directory with is_directory=true, to a new path within the same project; cross-project moves are refused. For a file, give either `destination_path` (project-relative, with the same file extension as the source, e.g. \"archive/note.md\"; `.markdown` may become `.md`) or `destination_folder` (keeps the filename). The file moves on disk and its index entry, observations, and relations move with it. The permalink stays the same unless the server's update_permalinks_on_move setting is on, so links that use it keep resolving; other notes' text is not rewritten.","propsAdded":[],"propsRemoved":[]},{"tool":"prompt:continue_conversation","description":false,"schema":true,"propsAdded":[],"propsRemoved":[]},{"tool":"prompt:getting_started","description":false,"schema":true,"propsAdded":[],"propsRemoved":[]},{"tool":"prompt:recent_activity","description":true,"schema":true,"before":"Get recent activity from a specific project or across all projects","after":"Get recent activity from one project: the given one, else the default project. Lists every project only when no default is set","propsAdded":[],"propsRemoved":[]},{"tool":"prompt:search_knowledge_base","description":false,"schema":true,"propsAdded":[],"propsRemoved":[]},{"tool":"read_content","description":true,"schema":false,"before":"Read 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","after":"Read a file's raw bytes by path, permalink, or memory:// URL, without knowledge-graph processing. Text and JSON come back as {\"type\": \"text\"}; images are re-encoded as JPEG and downscaled to about 350 KB; other binaries come back base64 as {\"type\": \"document\"} and are refused above 350 KB. Use read_note for markdown notes when you want note resolution and fallback search."},{"tool":"read_note","description":true,"schema":true,"before":"Read a markdown note by title or permalink.","after":"Read a markdown note by title or permalink, optionally a numbered line range. If the identifier doesn't resolve directly, a note whose title matches it exactly (case-insensitive) is returned with full content; otherwise it returns related-note suggestions from text search instead of content. Pass include_content=false to get only the note's metadata and checksum.","propsAdded":["end_line","include_content","start_line"],"propsRemoved":[]},{"tool":"recent_activity","description":true,"schema":true,"before":"Get recent activity for a project or across all projects.\n\n    Timeframe supports natural language formats like:\n    - \"2 days ago\"\n    - \"last week\"\n    - \"yesterday\"\n    - \"today\"\n    - \"3 weeks ago\"\n    Or standard formats like \"7d\"\n    ","after":"Get recent activity for one project.\n\n    With no project, this uses the configured default project. It lists activity\n    across all projects only when there is no default.\n\n    Timeframe supports natural language formats like:\n    - \"2 days ago\"\n    - \"last week\"\n    - \"yesterday\"\n    - \"today\"\n    - \"3 weeks ago\"\n    Or standard formats like \"7d\"\n    ","propsAdded":[],"propsRemoved":[]},{"tool":"schema_diff","description":true,"schema":false,"before":"Detect drift between a schema definition and actual note usage.","after":"Detect drift between a schema definition and actual note usage. A schema is a note with type: schema whose entity field names the note type it describes."},{"tool":"schema_infer","description":true,"schema":false,"before":"Analyze existing notes and suggest a Picoschema definition.","after":"Analyze existing notes of one type and suggest a Picoschema definition. A schema is a note with type: schema whose entity field names the note type it describes."},{"tool":"schema_validate","description":true,"schema":false,"before":"Validate notes against their Picoschema definitions.","after":"Validate notes against their Picoschema definitions. With neither note_type nor identifier it validates every note type that has a schema. A schema is a note with type: schema whose entity field names the note type it describes."},{"tool":"search","description":true,"schema":false,"before":"Search for content across the knowledge base","after":"OpenAI/ChatGPT connector search adapter. Returns one text item holding JSON {results, total_count, query} for the top 10 search_notes matches. Other MCP clients receive an unsupported-client error; use search_notes instead."},{"tool":"search_notes","description":true,"schema":true,"before":"Search across all content in the knowledge base with advanced syntax support.","after":"Search notes, observations, and relations in one project, or in several with `projects` / `search_all_projects`. The query supports quoted phrases, AND/OR/NOT with parentheses, and `tag:name` (converted to a tags filter). A plain multi-term query first requires every term and may fall back to any-term matching when that returns nothing. `search_type` selects text, title, permalink (a `*` glob matched against the full permalink path), vector/semantic, or hybrid; the default is hybrid when semantic search is enabled, otherwise text. Omit `query` to search by filters alone (metadata_filters, tags, status, note_types). Results are whole notes by default; a `categories` or valid-time filter switches the default to observations. `after_date` filters by when content was last updated. `valid_at` / `valid_overlaps` / `time_kind` filter by dates written inside notes (e.g. `@effective[2026-06-10,2026-07-27)`) and exclude undated content. Returns ranked, paginated results; read full content with read_note or cat. Syntax reference: memory://man/search-notes(3).","propsAdded":["compact","projects","time_kind","valid_at","valid_overlaps"],"propsRemoved":[]},{"tool":"view_note","description":true,"schema":false,"before":"View a note as a formatted artifact for better readability.","after":"Read a note (same resolution as read_note) and return it wrapped in an instruction to display it to the user as a markdown artifact. Use when the user wants to see the note rendered; use read_note when you need the content yourself. Not-found results are returned unwrapped."},{"tool":"write_note","description":true,"schema":true,"before":"Create a markdown note. If the note already exists, returns an error by default — pass overwrite=True to replace.","after":"Create a markdown note. If the note already exists, returns an error by default — pass overwrite=True to replace. directory is required. For incremental changes to an existing note use edit_note. A new note's result may list similar existing notes; that is advisory and does not block the write. Pass expected_checksum with overwrite=True to replace the note only if it is still the revision you read.","propsAdded":["expected_checksum"],"propsRemoved":[]}]},{"from":"0.24.1","to":"1.0.0","published":"2026-10-29","bump":"major","added":["bm_context","bm_delete","bm_edit","bm_find","bm_list","bm_man","bm_move","bm_project","bm_read","bm_schema","bm_search","bm_write"],"removed":["basic_memory_diagnostics","build_context","cat","create_memory_project","delete_note","delete_project","edit_note","fetch","find","grep","list_directory","list_memory_projects","list_workspaces","ls","man","move_note","read_content","read_note","recent_activity","schema_diff","schema_infer","schema_validate","search","search_notes","tail","view_note","write_note"],"changed":[{"tool":"prompt:continue_conversation","description":false,"schema":true,"propsAdded":["project"],"propsRemoved":[]},{"tool":"prompt:recent_activity","description":true,"schema":true,"before":"Get recent activity from one project: the given one, else the default project. Lists every project only when no default is set","after":"Get recent activity from the given or configured default project. Discover projects first when neither resolves.","propsAdded":[],"propsRemoved":[]},{"tool":"prompt:search_knowledge_base","description":false,"schema":true,"propsAdded":["project"],"propsRemoved":[]}]}]}}