ObsidianMCPServer

ObsidianMCPServer is a local Model Context Protocol (MCP) server that lets AI tools interact with an Obsidian vault by reading, writing, searching, and managing notes (including frontmatter and Periodic Notes) via the Obsidian “Local REST API” plugin over localhost.

Evaluated Mar 30, 2026 (22d ago)
Repo ↗ DevTools mcp obsidian notes automation local-rest-api swift
⚙ Agent Friendliness
60
/ 100
Can an agent use this?
🔒 Security
50
/ 100
Is it safe for agents?
⚡ Reliability
31
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
70
Documentation
70
Error Messages
0
Auth Simplicity
85
Rate Limits
20

🔒 Security

TLS Enforcement
60
Auth Strength
55
Scope Granularity
20
Dep. Hygiene
45
Secret Handling
70

README indicates the API key is local and server runs on localhost only; it also suggests enabling HTTPS in the plugin. However, there is no documented scope granularity or strong authorization model beyond the plugin API key, and the README does not provide details on secret logging/handling inside the MCP server or dependency vulnerability posture.

⚡ Reliability

Uptime/SLA
0
Version Stability
45
Breaking Changes
50
Error Recovery
30
AF Security Reliability

Best When

You have a trusted MCP client running on the same machine as Obsidian, and you want automated note operations and content transformations directly against your local vault.

Avoid When

You cannot trust the AI client/environment running the MCP integration, or you need robust authentication/authorization semantics for multiple users/roles.

Use Cases

  • Let Claude/Cursor (or other MCP clients) read and update specific Obsidian notes by filename
  • Vault-wide metadata operations (search-based tag and frontmatter transformations)
  • Automated journaling/workflows using Periodic Notes (daily/weekly/monthly/quarterly/yearly and date-specific variants)
  • Generate summaries, outlines, tags, and frontmatter using note content
  • Proofread and rewrite active notes while preserving formatting conventions

Not For

  • Public or untrusted network exposure (it is intended for localhost/local usage)
  • Use cases requiring strong enterprise-grade access control/auditing beyond the Obsidian plugin’s API key
  • High-assurance data residency/compliance workflows without additional review and guarantees

Interface

REST API
Yes
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
No
Webhooks
No

Authentication

Methods: Obsidian Local REST API plugin API key (OBSIDIAN_API_KEY) configured in MCP client environment
OAuth: No Scopes: No

Auth is delegated to the Obsidian Local REST API plugin via an API key; README does not describe fine-grained scopes for that key.

Pricing

Free tier: No
Requires CC: No

Open-source project (MIT). Costs depend on your AI tool usage and local compute; the package itself does not state pricing.

Agent Metadata

Pagination
none
Idempotent
False
Retry Guidance
Not documented

Known Gotchas

  • Modifying operations can change user content; agents should confirm targets (filename/date) before writing/deleting.
  • Operations depend on the Obsidian Local REST API plugin being running and base URL/API key matching the plugin settings.
  • Port/protocol mismatch is possible (HTTP 27123 vs HTTPS 27124).

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for ObsidianMCPServer.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-30.

8642
Packages Evaluated
17761
Need Evaluation
586
Need Re-evaluation
Community Powered