Obsidian Memory MCP

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

About

This project is a modified version of Anthropic's memory server that has been 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: Changed from JSON to individual Markdown files
Obsidian Integration: Added [[link]] syntax for relations
YAML Frontmatter: Metadata stored in frontmatter instead of JSON
File Structure: Each entity becomes a separate .md file
Removed Features: Simplified to focus on Markdown-only storage

Features

Markdown Storage: Individual .md files for each entity
Obsidian Integration: Uses [[link]] syntax for graph visualization
Knowledge Graph: Store entities, relations, and observations
Search Functionality: Query across all stored memories
YAML Frontmatter: Metadata stored in frontmatter

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]]

Installation & Configuration

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

Then configure 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 with Obsidian

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

The knowledge graph will be visualized with:

Entity files as nodes
[[links]] as edges
Different colors for different entity types (if configured in Obsidian)

API

The server exposes the following tools:

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

Development

npm run watch  # Watch for changes and rebuild

Credits

This project is based on Anthropic's memory server from the Model Context Protocol servers collection. We thank Anthropic for releasing the original implementation under the MIT license.

License

MIT License - see LICENSE file for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

Stores AI memories as Markdown files for visualization in Obsidian's graph view, allowing users to create knowledge graphs with entities, relations, and observations.

Related MCP Servers

obsidian-mcp
StevenStavrakis
-
security
A
license
-
quality
Enables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.
Last updated -
319
468
TypeScript
MIT License
MCP Obsidian
gregkonush
-
security
A
license
-
quality
A server implementation that allows AI assistants to read, create, and manipulate notes in Obsidian vaults through the Model Context Protocol.
Last updated -
821
5
TypeScript
MIT License
Roo Code Memory Bank MCP Server
IncomeStreamSurfer
A
security
A
license
A
quality
Enables AI assistants to maintain persistent project context across sessions by storing and retrieving structured information in markdown files organized in a memory bank directory.
Last updated -
4
53
JavaScript
Apache 2.0
Obsidian MCP Server
engineers-hub-ltd-in-house-project
-
security
A
license
-
quality
Allows AI models to interact with Obsidian notes through the Local REST API, enabling creation, reading, updating, searching of notes, and Git-based automatic backups.
Last updated -
193
JavaScript
MIT License

View all related MCP servers

Obsidian Memory MCP