High-performance Model Context Protocol (MCP) server for Obsidian that provides AI tools with direct vault access through semantic operations and HTTP transport.
Give AI semantic agency over your knowledge graph
This plugin connects your Obsidian vault to AI assistants through MCP (Model Context Protocol), giving them the ability to understand and navigate your notes as a connected knowledge graph, not just isolated files. Through semantic hints and graph traversal, AI gains the agency to explore concepts, follow connections, and synthesize information across your entire vault.
MCP (Model Context Protocol) is the open standard that lets AI assistants interact with external tools and data sources. This plugin works with any MCP-compatible client including:
Traditional file access gives AI a narrow view - one document at a time. This plugin transforms that into semantic agency:
Prerequisites: You need an MCP-compatible AI client like Claude Desktop, Claude Code, or Continue.dev.
Via Obsidian Community Plugins (coming soon)
Via BRAT (for beta testing)
aaronsb/obsidian-mcp-pluginClaude Code
claude mcp add --transport http obsidian http://localhost:3001/mcp --header "Authorization: Bearer YOUR_API_KEY"
Claude Desktop, Cline, and other MCP clients
{
"mcpServers": {
"obsidian-vault": {
"transport": {
"type": "http",
"url": "http://localhost:3001/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
}
Copy the ready-to-use config with your API key from the plugin settings page.
Once connected, simply chat with your AI assistant about your notes! For example:
Your AI assistant now has these capabilities:
The plugin provides 8 semantic tool groups that give AI comprehensive vault access:
| Tool | Purpose | Key Actions |
|---|---|---|
| 📁 vault | File operations | list, read, create, search, move, split, combine |
| ✏️ edit | Content modification | window editing, append, patch sections |
| 👁️ view | Content display | view files, windows, active note |
| 🕸️ graph | Link navigation | traverse, find paths, analyze connections |
| 💡 workflow | Contextual hints | suggest next actions based on state |
| 📊 dataview | Query notes | Execute DQL queries (if installed) |
| 🗃️ bases | Database views | Query and export Bases (if available) |
| ℹ️ system | Vault info | Server status, commands, web fetch |
Detailed documentation for each tool and feature:
This plugin doesn't just give AI access to files - it provides semantic understanding:
User: "Summarize my research on machine learning optimization"
AI uses semantic tools to:
1. Search for notes with ML optimization concepts
2. Traverse graph to find related papers and techniques
3. Follow backlinks to discover applications
4. Synthesize findings from multiple connected notes
User: "What connections exist between my notes on philosophy and cognitive science?"
AI uses graph tools to:
1. Find notes tagged with both topics
2. Analyze shared concepts via graph traversal
3. Identify bridge notes that connect domains
4. Map the conceptual overlap
tag:, path:, content:Access settings via: Settings → Community plugins → Semantic MCP
Key configuration options: