Basic Memory MCP Server

Knowledge & MemoryPython

A knowledge management system that builds a persistent semantic graph from AI conversations

Available Tools

search_notes

Search through notes in the knowledge base using semantic or keyword search

querylimitsearch_type

create_note

Create a new note in the knowledge base

titlecontenttags

update_note

Update an existing note in the knowledge base

titlecontent

get_note

Retrieve the content of a specific note by title

title

recent_activity

Get a list of recently created or modified notes

limitactivity_type

Basic Memory is a powerful knowledge management system that allows you to create and maintain a persistent semantic graph from your conversations with AI assistants. It stores information in standard Markdown files on your computer, making it easy to integrate with tools like Obsidian.md. The system helps you build a personal knowledge base that grows with each interaction, allowing AI assistants to reference and build upon previous conversations. By organizing information semantically, Basic Memory makes it easier to retrieve relevant information and maintain context across multiple sessions.

Basic Memory: Your Semantic Knowledge Graph for AI Conversations

Basic Memory creates a persistent knowledge graph from your AI conversations, storing everything in standard Markdown files that integrate seamlessly with tools like Obsidian.md.

Installation

There are several ways to install Basic Memory:

Option 1: Using pip

pip install basic-memory

Option 2: Using the installer script

For Unix-based systems (macOS, Linux):

curl -sSL https://raw.githubusercontent.com/basicmachines-co/basic-memory/main/scripts/install.sh | bash

Option 3: Clone the repository

git clone https://github.com/basicmachines-co/basic-memory.git
cd basic-memory
pip install -e .

Configuration

After installation, you need to configure Basic Memory:

Create a directory for your notes (or use an existing Obsidian vault)
Run the Basic Memory MCP server with the path to your notes directory:

basic-memory mcp --notes-dir /path/to/your/notes

You can also specify a specific project within your notes:

basic-memory mcp --notes-dir /path/to/your/notes --project "Project Name"

Usage

Once the MCP server is running, you can connect to it from AI assistants that support the Model Context Protocol. Basic Memory provides several tools that allow the AI to:

Search through your notes
Create new notes
Update existing notes
View recent activity
Manage entities and relationships in your knowledge graph

The system automatically creates a semantic graph from your conversations, linking related concepts and making it easy to retrieve relevant information later.

Integration with Obsidian

Basic Memory works particularly well with Obsidian.md:

Point Basic Memory to your Obsidian vault directory
Notes created or updated by Basic Memory will appear in your Obsidian vault
You can use Obsidian's powerful linking and visualization features to explore your knowledge graph

Best Practices

Create a dedicated project for each major topic or area of work
Let the AI assistant create and organize notes based on your conversations
Review and refine the knowledge graph periodically
Use the search functionality to help the AI find relevant information from past conversations

For more detailed information, visit the Basic Memory website or refer to the GitHub repository.