obsidian-mcp-plugin
starsforks
How to install obsidian-mcp-plugin?
aaronsb/obsidian-mcp-plugin
$git clone https://github.com/aaronsb/obsidian-mcp-plugin📦 [Available in the Obsidian Community Plugin directory →](https://community.obsidian.md/plugins/semantic-vault-mcp)
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:// |
People who liked this also viewed
6 picksType
- fastmcp🚀 The fast, Pythonic way to build MCP servers and clients.MCP ServersJul 2026
- playwright-mcpPlaywright MCP serverMCP ServersJul 2026
- ext-appsOfficial repo for spec & SDK of MCP Apps protocol - standard for UIs embedded AI chatbots, served by MCP serversMCP ServersJul 2026
- langchain-mcp-adaptersLangChain 🔌 MCPMCP ServersJul 2026
- mcporterCall MCPs via TypeScript, masquerading as simple TypeScript API. Or package them as cli.MCP ServersJul 2026
- mcp-proxyA bridge between Streamable HTTP and stdio MCP transportsMCP ServersJul 2026
