Your Obsidian vault is your second brain. Years of notes, project plans, daily journals, meeting records, research — all connected with wikilinks and tags in a carefully organized folder of Markdown files.
But your AI can't see any of it. You copy-paste snippets into ChatGPT. You describe your note structure to Claude. You manually relay information between your knowledge base and your AI.
That ends now. MCPBundles provides an Obsidian MCP bundle — 35 tools that give your AI full read/write access to your vault through the Model Context Protocol. It's a standard MCP server — the tools show up natively in whatever AI you already use. Claude Desktop, ChatGPT, Cursor, Windsurf, the mcpbundles CLI, or any MCP-compatible client.
35 tools. Your AI becomes an Obsidian power user.
The Obsidian MCP bundle gives your AI the same access to your vault that you have — and then some. It reads notes and gets back structured data — parsed frontmatter, tags, file stats — not just raw text. It browses your folder hierarchy. It searches across every note in your vault with relevance scoring, regex patterns, frontmatter queries, and date ranges.
It writes. Not just "dump a whole file" writing. Your AI can create notes with full frontmatter, append entries to existing notes, and — this is the part that matters — surgically edit specific sections of a document without touching anything else.
It sees your images. It analyzes your graph structure. It finds orphaned notes and broken links. It lists every task across your entire vault.
Surgical edits change everything
Most integrations that touch files do the same thing: read the whole file, modify it in memory, overwrite the whole file. Fine for code. Terrible for a living document with dozens of sections, tasks, and metadata fields that you don't want an AI to accidentally mangle.
The Obsidian PATCH operation works differently. Your AI targets a specific heading, block reference, or frontmatter field and inserts, replaces, or appends content just there.
Say you've got a project plan with milestones, discussion notes, and action items. You tell your AI to add two items to the milestones section. It reads the document map (a lightweight call that returns all headings, block refs, and frontmatter fields), finds the right heading, and appends only to that section. Your discussion notes and action items stay exactly as they were.
The same precision works for frontmatter. Your AI can flip status: draft to status: shipped on a single field without rewriting the YAML block. It can add a new reviewer: Tony field that didn't exist before. It can target nested heading paths like "Launch Plan::Key Milestones" to reach the right section in a deeply structured document.
This is the difference between an AI that can edit text files and an AI that understands Obsidian's document structure.
Daily notes are the fast path
The most common Obsidian workflow is appending to today's daily note. A quick thought, a task, a meeting summary — you open today's note and add a line.
Your AI does the same thing in one call. No need to figure out today's date, construct the filename, check if the file exists. Just "append this to my daily note." It handles the rest, including creating the note if it doesn't exist yet.
This turns your AI into a persistent journal. Every conversation can leave a trace in your vault. Meeting summaries go into the daily note. Research findings get filed in project notes. Action items land where they belong.
Your AI can see your images
When your AI reads an image from your vault, it doesn't get a file path or a base64 blob dumped into a text response. It gets the actual image as an MCP ImageContent block — the same way a screenshot tool returns visual content.
That means any AI model with vision — Claude, GPT-4o, Gemini — actually sees the image. Your AI can describe a diagram, read handwritten notes from a photo, interpret a screenshot, or analyze a chart. All from files already sitting in your vault.
PNG, JPEG, GIF, WebP, BMP, and SVG are all supported. The image flows through the same proxy tunnel as everything else — nothing gets stored on MCPBundles servers.
Graph analysis and vault maintenance
Obsidian's power comes from connections between notes. Wikilinks turn a folder of Markdown files into a knowledge graph. But maintaining that graph — finding orphans, fixing broken links, understanding relationships — is manual work.
Your AI traverses your link graph. Graph neighbors does a breadth-first search from any note, finding every connected note within a configurable depth. Direction matters: outgoing links, incoming backlinks, or both.
Orphan detection scans every note in your vault and identifies the ones with zero incoming wikilinks — notes that nothing else links to. These are the ones you forgot about, the stubs you never connected, the ideas that fell through the cracks.
Broken link detection scans every wikilink in every note and checks whether the target actually exists. That reference to [[Old Project Name]] you renamed three months ago? Found.
Task management across your entire vault
Obsidian is great for tasks — the checkbox syntax (- [ ] do the thing) works in any note. But there's no built-in way to see tasks across your entire vault. Your AI can.
The task listing tool scans every note, extracts every checkbox, and returns them with their source file and line number. Filter by status (open, completed, all), by folder, by tag, or by keyword. Ask your AI "what are my open tasks tagged with Q2?" and get an answer without installing any plugins.
How the proxy tunnel works
Obsidian runs on your desktop. AI services run in the cloud. The MCPBundles desktop proxy bridges them with an encrypted tunnel.
AI → MCPBundles → Proxy Tunnel → Your Desktop → Obsidian (localhost:27124)
Your vault data flows through the tunnel in real time. Nothing gets stored on MCPBundles servers. The proxy handles Obsidian's self-signed TLS certificate automatically.
Works with the AI you already use
MCPBundles is a remote MCP server. You connect it once and the Obsidian tools appear in your AI's tool list — alongside any other bundles you've enabled.
Claude Desktop, ChatGPT, Cursor, Windsurf — add the MCPBundles MCP server URL and the tools are there.
mcpbundles CLI — for terminal workflows, scripting, and automation. pip install mcpbundles and you're set.
Any MCP-compatible client — if it speaks MCP, it works. The tools are standard MCP tools with proper schemas, annotations, and content types.
Five minutes to set up
1. Install the Obsidian plugin
Install the Local REST API community plugin in Obsidian (by Adam Coddington). Enable it and copy the API key from the plugin settings.
2. Start the proxy
pip install mcpbundles
mcpbundles login
mcpbundles proxy start
3. Enable the bundle
Go to MCPBundles, enable the Obsidian bundle, and paste your API key. The 35 tools are now available to every AI client connected to your MCPBundles server.
What this looks like in practice
You're prepping for a team meeting. You tell your AI: "Create meeting notes for the Q2 planning sync with attendees Tony and Sarah, agenda: hiring, roadmap, budget." A fully structured note appears in your vault with frontmatter, sections, and wikilinks to related project notes.
After the meeting, you tell your AI to append the action items. It doesn't overwrite your agenda — it surgically appends to the action items section.
Later, you ask your AI to search your vault for everything related to "database migration." It finds four notes across different projects, reads them, and creates a consolidated summary note linking back to the originals.
You photographed a whiteboard and dropped the image into your vault. Your AI sees the photo, reads the sticky notes, and creates structured tasks in a new project note.
Your vault has grown to 500 notes. You ask your AI to run a health check. It finds 23 orphaned notes, 7 broken wikilinks, and 45 open tasks scattered across 12 files. It creates a maintenance summary with links to every issue.
None of this requires you to leave your AI chat.
Get started
pip install mcpbundles
mcpbundles login
mcpbundles proxy start
Enable the Obsidian bundle, add your API key, and start talking to your vault.
MCPBundles is a hosted platform for connecting AI agents to real third-party services via the Model Context Protocol. 60+ bundles, 1900+ tools — Stripe, HubSpot, Postgres, Gmail, Obsidian, and more. Get started free.
Top comments (0)