Back to timeline

Tue, October 2020:01ToolsAPI & pricingMCP & SkillsAI codingAPI & pricing guide

Obsidian local REST API plugin bundles an MCP server so AI clients can connect directly to your vault

Decision Brief

What changedThe obsidian-local-rest-api plugin exposes an HTTPS REST API and a built-in MCP server, letting scripts, browser extensions, and AI clients read, write, surgically patch, search, and subscribe to events in an Obsidian vault.
Why it mattersFor developers using Obsidian, this means MCP clients that support Streamable HTTP, like Claude Code and Cursor, can read and write notes directly without building a glue layer, but API key and config-directory access control become new concerns.
Who should careAI coding tool users, Agent builders
Affected stackClaude CodeMCPCursor
Builder actionCheck whether your existing MCP servers are affected
Source confidenceHigh · Official release / blog / repo

The plugin serves an HTTPS REST API on local 127.0.0.1:27124 and also bundles an MCP server at /mcp/; both expose the same core capabilities: CRUD on any vault file, targeted patches to headings, block references, and frontmatter keys, full-text search and JsonLogic structured queries, event-stream subscriptions, and listing and running Obsidian commands and querying tags. All requests require API key auth, and on first run the plugin creates its own name-constrained certificate authority valid only for specified hostnames such as 127.0.0.1 and localhost, preventing impersonation of other sites. Onboarding differs by client: Claude Code natively supports HTTP MCP and needs a single CLI command; Cursor supports Streamable HTTP via an mcp.json entry; Claude Desktop doesn't support remote HTTP MCP and needs an mcp-remote bridge (Node.js required). Several hard security constraints apply: the API refuses reads and writes to the .obsidian config directory (including data.json, which stores the API key), since writing there is equivalent to remote code execution; ten bad credentials from the same origin within a minute trigger 429 rate limiting, while requests with a valid key are unaffected; and writes support If-Match/If-None-Match conditional requests to prevent two clients from overwriting the same note. For developers managing a knowledge base in Obsidian who want AI agents to operate on notes directly, these rules determine whether a safe integration is possible.

Summary basis: full article readCompiled from the source scope noted above; the original remains authoritative.

Sources

Related intel

留言

登入后即可留言,和其他 builder 交换实测心得。

还没有留言,抢头香。