easy-obsidian-mcp is an MCP (Model Context Protocol) server for Obsidian users, designed to connect AI assistants with local Obsidian vaults, enabling AI to access and manipulate note content.
Purpose: This tool is mainly used to bridge the channel between AI assistants (such as Claude, ChatGPT, etc.) and Obsidian vaults, so that AI can search, read, and analyze based on the user's existing notes, thereby assisting knowledge management and information retrieval.
Main capabilities: According to the repository description, this tool supports searching all notes (including fuzzy search with spelling errors), finding connections between notes, executing Dataview queries, reading specific notes, and listing files and folders. It implements note creation, reading, updating, and searching through filesystem access.
Usage: This tool needs to be installed for use in an AI application. For Claude Desktop, the configuration needs to be added to claude_desktop_config.json (the Mac path is ~/Library/Application Support/Claude/claude_desktop_config.json, and the Windows path is %APPDATA%\Claude\claude_desktop_config.json). For Cursor, it needs to be added to the settings by opening "Preferences: Open User Settings (JSON)" with Cmd+Shift+P. In addition, to enable full functionality, optionally enable the Obsidian API: open Obsidian → Settings → Community plugins, turn off Restricted mode → search for "Local REST API" → install and enable it, then add the API key to the configuration's env, i.e. "env" : { "OBSIDIAN_API_KEY" : "your-api-key-here" }.
Applicable scenarios: Suitable for users who want to use an AI assistant to retrieve and analyze their personal Obsidian vault, such as searching for notes on a specific topic, finding notes by time, reviewing meeting notes, finding orphaned notes, etc. Example questions include: "Search my notes for machine learning", "Find all notes I created this week", "What meetings did I have last month?", "Show me orphaned notes".
Limitations and notes: Before use, ensure that Obsidian is running, the Local REST API plugin is enabled, and the API key is correct. Information about fees, pricing, platform support scope, specific version requirements, etc. is not currently provided in the materials.
