obsidian-mcp-plugin
byaaronsb· 2 MCP servers
📦 [Available in the Obsidian Community Plugin directory →](https://community.obsidian.md/plugins/semantic-vault-mcp)
How to install obsidian-mcp-plugin?
aaronsb/obsidian-mcp-plugin
$git clone https://github.com/aaronsb/obsidian-mcp-pluginInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install obsidian-mcp-plugin by running `git clone https://github.com/aaronsb/obsidian-mcp-plugin`, then use it for the current task and follow its documentation at https://github.com/aaronsb/obsidian-mcp-plugin.
README.md
| 1 | # Semantic Notes Vault MCP |
| 2 | |
| 3 |  |
| 4 |  |
| 5 |  |
| 6 |  |
| 7 |  |
| 8 | |
| 9 | 📦 **[Available in the Obsidian Community Plugin directory →](https://community.obsidian.md/plugins/semantic-vault-mcp)** |
| 10 | |
| 11 | **Read, write, search, and traverse your Obsidian vault from any AI assistant — through an MCP server that runs _inside_ Obsidian.** |
| 12 | |
| 13 | No external Node process to launch, no separate REST-API plugin to bridge through: the server *is* the plugin. Setup is a drag-and-drop — drop the `.mcpb` bundle onto Claude Desktop, paste your key, done. |
| 14 | |
| 15 | It exposes **8 powerful tools** — each a whole family of operations, not a single call (the `vault` tool alone handles 13: list, read, create, search, move, split, combine, and more) — with first-class **Dataview** and **Bases** support plus graph traversal across links, tags, and backlinks. And every operation respects the permissions *you* set — a read-only mode, per-operation controls, and path allow/block lists — so the AI only ever does what you've allowed, not unrestricted run of your vault. |
| 16 | |
| 17 | **Works with any MCP-compatible client** — Claude Desktop, Claude Code, Cline, Continue.dev, and anything that speaks local MCP. |
| 18 | |
| 19 | > **New to MCP?** The [Model Context Protocol](https://modelcontextprotocol.io) is the open standard that lets AI assistants interact with external tools and data. You don't need to understand it to use this — the [Quick Start](#quick-start) is three steps. |
| 20 | |
| 21 | ## Quick Start |
| 22 | |
| 23 | **Prerequisites:** an MCP-compatible AI client like Claude Desktop, Claude Code, or Continue.dev. |
| 24 | |
| 25 | > ## 📦 ──drag──▶ 🤖💬 |
| 26 | > **Download the `.mcpb` bundle from the plugin's config page → drag it onto Claude Desktop → paste your key. Done.** |
| 27 | |
| 28 | For most people that's the entire setup. The numbered steps below spell it out, then cover other MCP clients. |
| 29 | |
| 30 | ### 1. Install the Plugin |
| 31 | |
| 32 | **Via Obsidian Community Plugins** |
| 33 | - Open Settings → Community plugins → Browse |
| 34 | - Search for "Semantic Notes Vault MCP" |
| 35 | - Install and enable — or install straight from the [plugin listing](https://community.obsidian.md/plugins/semantic-vault-mcp) |
| 36 | |
| 37 | **Via BRAT** (for beta testing) |
| 38 | - Install [BRAT](https://github.com/TfTHacker/obsidian42-brat) |
| 39 | - Add beta plugin: `aaronsb/obsidian-mcp-plugin` |
| 40 | |
| 41 | ### 2. Configure Your AI Client |
| 42 | |
| 43 | Three onboarding paths, ordered by audience. All three are also shown in the plugin's Settings tab with copy-ready values. |
| 44 | |
| 45 | **📦 → 🤖 Claude Desktop — one-click `.mcpb` install (recommended)** |
| 46 | |
| 47 | Download `obsidian-mcp-<version>.mcpb` — either from the plugin's **Settings** tab (button right on the config page) or the [latest release](https://github.com/aaronsb/obsidian-mcp-plugin/releases/latest) — then either drag it onto the Claude Desktop window or double-click it. Claude Desktop opens an install dialog with two fields — paste the URL and API key shown in the plugin's Settings tab, hit Save, and you're done. |
| 48 | |
| 49 | > *Cross-platform note:* `.mcpb` files install via Claude Desktop's bundled handler. If double-click doesn't trigger Claude on your system, drag the file onto Claude Desktop's window instead, or right-click → "Open with…" and pick Claude Desktop (then "always open with" if your OS asks). Behavior varies by platform: macOS usually auto-associates, Windows may need a one-time association, Linux varies by desktop environment. |
| 50 | |
| 51 | **Claude Code** — one command (copy the ready-made version with your API key from the plugin's Settings tab): |
| 52 | |
| 53 | ```bash |
| 54 | claude mcp add --transport http obsidian http://localhost:3001/mcp --header "Authorization: Bearer YOUR_API_KEY" |
| 55 | ``` |
| 56 | |
| 57 | For HTTPS, use `https:// |
Related
6 picksType
- Context7Up-to-date library docs injected straight into your promptstoday
- repomixA tool to pack repository contents to single file for AI consumptionJul 2026
- markitdown-mcpA Model Context Protocol server for converting documents to Markdown using MarkItDownJun 2026
- anytype-mcpOfficial MCP server for Anytype API - your encrypted, local and collaborative wiki.Jul 2026
- mcp-server-atlassian-confluenceNode.js/TypeScript MCP server for Atlassian Confluence. Provides tools enabling AI systems (LLMs) to list/get spaces & pages (content formatted as Markdown) and search via CQL. Connects AI seamlessly to Confluence knowledge bases using the standard MCP interface.Feb 2026
- obsidian-mcp-server-enhancedThis is an enhanced version of the excellent cyanheads/obsidian-mcp-server with additional features specifically tailored for remote Claude.ai integration, advanced task querying, and security via Tailscale.Jul 2026
