Obsidian MCP Server
About
MCP server enabling AI agents to perform natural knowledge discovery and analysis across Obsidian vault
Details
- Author
- pmmvr
- GitHub stars
- 21
- Downloads
- 426
- Categories
- Knowledge Base
Jump to
- Advanced search with text, regex, and filter options
- Retrieve full note content and metadata
- Browse vault directory structure efficiently
- Filter by folder, title, tag, and creation/modification dates
- OR/AND logic for multiple title and tag terms
- Context length control and pagination for large vaults
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Obsidian MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via pip or uv (pip install obsidian-api-mcp-server), set the required environment variables (OBSIDIAN_API_URL, optionally OBSIDIAN_API_KEY), and add the server to your MCP client configuration. Run the server with obsidian-mcp. It provides three tools: search_vault, get_note_content, and browse_vault_structure.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"obsidian mcp server": {
"obsidian-api-mcp-server": {
"command": "uv",
"args": [
"pip",
"install",
"obsidian-api-mcp-server"
]
}
}
}
}McpServers
{
"obsidian-api-mcp-server": {
"command": "uv",
"args": [
"pip",
"install",
"obsidian-api-mcp-server"
]
}
}Obsidian MCP Server
An MCP (Model Context Protocol) server that enables AI agents to perform sophisticated knowledge discovery and analysis across your Obsidian vault through the Local REST API plugin.
<a href="https://glama.ai/mcp/servers/@pmmvr/obsidian-api-mcp-server">
</a>
Why This Matters
This server transforms your Obsidian vault into a powerful knowledge base for AI agents, enabling complex multi-step workflows like:
- "Retrieve notes from my 'Projects/Planning' folder containing 'roadmap' or 'timeline' in titles, created after April 1st, then analyze them for any blockers or dependencies and present a consolidated risk assessment with references to the source notes"
- "Find all notes tagged with 'research' or 'analysis' from the last month, scan their content for incomplete sections or open questions, then cross-reference with my 'Team/Expertise' notes to suggest which colleagues could help address each gap"
- "Get the complete content of meeting notes from 'Leadership/Quarterly' containing 'budget' or 'headcount', analyze them for action items assigned to my department, and create a chronological timeline with source note references"
The server's advanced filtering, regex support, and full content retrieval capabilities allow agents to perform nuanced knowledge work that would take hours manually.
Prerequisites
1. Install the Obsidian Local REST API plugin in your Obsidian vault
2. Configure and enable the plugin in Obsidian settings
3. Note the API URL (default: https://localhost:27124) and API key if you've set one
Installation
From PyPI (Recommended)
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
