mcp/basic-memory repository overview

⁠Basic Memory MCP Server

Basic Memory is a knowledge management system that allows you to build a persistent semantic graph from conversations with AI assistants, stored in standard Markdown files on your computer. Integrates directly with Obsidan.md.

What is an MCP Server?⁠

⁠Characteristics

Attribute	Details
Image Source	Official Image
Docker Image	mcp/basic-memory⁠
Author	basicmachines-co⁠
Repository	https://github.com/basicmachines-co/basic-memory⁠
Dockerfile	https://github.com/basicmachines-co/basic-memory/blob/main/Dockerfile⁠
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/basic-memory --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
Licence	GNU Affero General Public License v3.0

⁠Available Tools

⁠Tools Details

⁠Tool: build_context

Build context from a memory:// URI to continue conversations naturally.

Use this to follow up on previous discussions or explore related topics.
Timeframes support natural language like:
- "2 days ago"
- "last week" 
- "today"
- "3 months ago"
Or standard formats like "7d", "24h"

⁠Tool: canvas

Create an Obsidian canvas file to visualize concepts and connections.

⁠Tool: delete_note

Delete a note by title or permalink

⁠Tool: project_info

Get information and statistics about the current Basic Memory project.

⁠Tool: read_content

Read a file's raw content by path or permalink

⁠Tool: read_note

Read a markdown note by title or permalink.

⁠Tool: recent_activity

Get recent activity from across the knowledge base.

Timeframe supports natural language formats like:
- "2 days ago"  
- "last week"
- "yesterday" 
- "today"
- "3 weeks ago"
Or standard formats like "7d"

⁠Tool: search_notes

Search across all content in the knowledge base.

⁠Tool: write_note

Create or update a markdown note. Returns a markdown formatted summary of the semantic content.

⁠Use this MCP Server

{
  "mcpServers": {
    "basic-memory": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/basic-memory"
      ]
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠