Obsidian Semantic MCP Server

Obsidian Semantic MCP Server is an MCP server that connects local Obsidian vaults to AI assistants like Claude Desktop by consolidating over twenty granular tools into five semantic operations. Knowledge workers, researchers, and writers use this server to automate vault maintenance, retrieve markdown notes, and perform structured edits without overloading the context window. Instead of exposing individual API functions, the server organizes interactions into vault, edit, view, workflow, and system operations. This approach delivers state-aware workflow suggestions, error recovery hints, and adaptive fragment retrieval to extract relevant document sections rather than loading full files. It interfaces directly with Obsidian through the community Local REST API plugin, enabling fuzzy window matching for text replacement, targeted section patching beneath Markdown headings, and token-efficient searches. By wrapping note operations in guided semantic layers, the server allows AI agents to traverse internal links, create synthesis documents, and manage interconnected knowledge bases with reduced token consumption and fewer operational errors.

Category: AI Memory & Context

Tags: knowledge-graph, markdown, obsidian, semantic search, vault

Visit Obsidian Semantic MCP Server

How to install and configure Obsidian Semantic MCP Server

1. Open Obsidian, navigate to Settings > Community Plugins, search for "Local REST API" by Adam Coddington, install it, enable it, and copy your generated API key from the plugin settings. 2. Ensure you have Node.js and the Claude Desktop application installed on your computer. 3. Open your Claude Desktop configuration file (located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS). 4. Add the Obsidian server entry under the mcpServers object: json { "mcpServers": { "obsidian": { "command": "npx", "args": ["-y", "obsidian-semantic-mcp"], "env": { "OBSIDIAN_API_KEY": "your-api-key-here", "OBSIDIAN_API_URL": "https://127.0.0.1:27124", "OBSIDIAN_VAULT_NAME": "your-vault-name" } } } } 5. Replace your-api-key-here with your API key, specify your vault name, and restart Claude Desktop.

What you can do with Obsidian Semantic MCP Server

• Execute fuzzy-matched text edits across daily notes to correct spelling errors and update task progress without manual copy-pasting. - Extract relevant document fragments from extensive Markdown research files using adaptive or proximity searches to conserve AI context tokens. - Traverse internal wiki links across connected notes to automatically generate summary files or literature reviews from existing vault content. - Append structured checklist items, notes, or log entries beneath specific Markdown headings using targeted patch operations. - Fetch external web articles and convert them directly into clean Markdown files saved into designated vault directories.

Key facts

• Open Source
• https://github.com/aaronsb/obsidian-semantic-mcp
• AI Memory & Context, Notes & Knowledge Management
• knowledge-graph, markdown, obsidian, semantic search, vault

Part of MCP Servers

What can Obsidian Semantic MCP Server do?

The server enables AI assistants to search, read, edit, and organize files within an Obsidian vault. It collapses traditional tool sprawl into five core actions: vault file management, fuzzy text editing, contextual viewing, workflow suggestions, and system utilities. It also provides automatic fragment retrieval to summarize long files efficiently.

How do I install Obsidian Semantic MCP Server?

To install the server, set up the Local REST API plugin in Obsidian and obtain your API key. Then, configure Claude Desktop by adding an entry in its JSON configuration file specifying the npx execution command for obsidian-semantic-mcp along with your API key, vault name, and local server URL.

Which MCP clients work with Obsidian Semantic MCP Server?

The server is primarily documented for use with Claude Desktop via standard Model Context Protocol configuration files. Any MCP client that supports stdio process execution and environment variable injection can connect to the server once Node.js and the Obsidian Local REST API plugin are configured.

Is Obsidian Semantic MCP Server open source?

Yes, Obsidian Semantic MCP Server is an open-source project hosted on GitHub. Users can inspect the source code, adjust workflow templates in the configuration files, review implementation details, submit pull requests, or contribute improvements directly through the project repository.