{"id":"otaviocc-obsidianmcpserver","name":"ObsidianMCPServer","homepage":null,"repo_url":"https://github.com/otaviocc/ObsidianMCPServer","category":"devtools","subcategories":[],"tags":["mcp","obsidian","notes","automation","local-rest-api","swift"],"what_it_does":"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.","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"],"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.","alternatives":["Use the Obsidian Local REST API directly from your own integration (instead of MCP)","Community/community plugins or scripts that call the Obsidian Local REST API","Write a custom MCP server tailored to your vault schema/workflow (with stricter controls)","Other note-search/indexing approaches that do not modify files (read-only RAG over exports)"],"af_score":60.2,"security_score":50.5,"reliability_score":31.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:41:21.839000+00:00","interface":{"has_rest_api":true,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Obsidian Local REST API plugin API key (OBSIDIAN_API_KEY) configured in MCP client environment"],"oauth":false,"scopes":false,"notes":"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":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Open-source project (MIT). Costs depend on your AI tool usage and local compute; the package itself does not state pricing."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":60.2,"security_score":50.5,"reliability_score":31.2,"mcp_server_quality":70.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":85.0,"rate_limit_clarity":20.0,"tls_enforcement":60.0,"auth_strength":55.0,"scope_granularity":20.0,"dependency_hygiene":45.0,"secret_handling":70.0,"security_notes":"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.","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":50.0,"error_recovery":30.0,"idempotency_support":"false","idempotency_notes":"No explicit guidance on idempotency; several operations (append/delete/update/create) may be non-idempotent depending on implementation.","pagination_style":"none","retry_guidance_documented":false,"known_agent_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)."]}}