Obsidian Memory MCP

🚀 Obsidian Memory MCP

An MCP server that stores AI memories as Markdown files for visualization in Obsidian's graph view.

🚀 Quick Start

The Obsidian Memory MCP is an MCP server designed to store AI memories as Markdown files, enabling visualization in Obsidian's graph view.

✨ Features

• Markdown Storage: Each entity is stored as an individual .md file.
• Obsidian Integration: Utilizes the [[link]] syntax for graph visualization.
• Knowledge Graph: Capable of storing entities, relations, and observations.
• Search Functionality: Allows querying across all stored memories.
• YAML Frontmatter: Metadata is stored in the frontmatter.

📦 Installation

First, clone the repository and install the necessary dependencies:

git clone https://github.com/YuNaga224/obsidian-memory-mcp.git
cd obsidian-memory-mcp
npm install
npm run build

Then, configure it in Claude Desktop:

{
  "mcpServers": {
    "obsidian-memory": {
      "command": "node",
      "args": ["/full/path/to/obsidian-memory-mcp/dist/index.js"],
      "env": {
        "MEMORY_DIR": "/path/to/your/obsidian/vault"
      }
    }
  }
}

💻 Usage Examples

Basic Usage

1. Configure Claude Desktop with one of the options above.
2. Restart Claude Desktop.
3. Use the MCP memory tools to create entities and relations.
4. Open Obsidian and view the graph.

The knowledge graph will be visualized with entity files as nodes, [[links]] as edges, and different colors for different entity types (if configured in Obsidian).

Advanced Usage

The server exposes a set of APIs for various operations:

• create_entities: Create new entities.
• create_relations: Create relations between entities.
• add_observations: Add observations to existing entities.
• delete_entities: Delete entities and related data.
• delete_observations: Remove specific observations.
• delete_relations: Remove relations.
• read_graph: Get the entire knowledge graph.
• search_nodes: Search entities by query.
• open_nodes: Get specific entities by name.

📚 Documentation

About

This project is a modified version of Anthropic's memory server adapted for Obsidian integration. The original server stored memories in JSON format, while this version stores them as individual Markdown files with Obsidian-compatible [[link]] syntax for graph visualization.

Key Changes from Original

Storage Format

Each entity is stored as an individual Markdown file with:

• YAML frontmatter for metadata (entityType, created, updated).
• Obsidian-compatible [[links]] for relations.
• Organized sections for observations and relations.

Example entity file (John_Doe.md):

---
entityType: person
created: 2025-07-10
updated: 2025-07-10
---

# John Doe

## Observations
- Works at Tech Corp
- Expert in TypeScript
- Lives in Tokyo

## Relations
- [[Manager of::Alice Smith]]
- [[Collaborates with::Bob Johnson]]
- [[Located in::Tokyo Office]]

🔧 Technical Details

During development, you can use the following command to watch for changes and rebuild:

npm run watch

📄 License

This project is released under the MIT License. See the LICENSE file for details.

• Original memory server: Copyright (c) 2024 Anthropic, PBC
• Obsidian integration modifications: Copyright (c) 2025 YuNaga224

We thank Anthropic for releasing the original implementation under the MIT license.