{"id":"aaronsb-obsidian-mcp-plugin","name":"obsidian-mcp-plugin","homepage":null,"repo_url":"https://github.com/aaronsb/obsidian-mcp-plugin","category":"ai-ml","subcategories":[],"tags":["obsidian","mcp","semantic-search","graph","knowledge-management","developer-tools","local-integration"],"what_it_does":"Provides an MCP (Model Context Protocol) server for Obsidian that exposes semantic, graph-aware tools for an AI assistant to read, search, and modify content in an Obsidian vault over HTTP transport (optionally with HTTPS).","use_cases":["Ask questions over an Obsidian knowledge graph with semantic search and link traversal","Summarize or synthesize notes across related topics and backlinks","Find connections between notes and map multi-hop paths in the vault graph","Execute note queries via Dataview integration (if installed)","Query and export data from Obsidian Bases (if available)","Create or edit notes with structure-aware operations (read-only mode available)"],"not_for":["Use where you need strong enterprise-grade API governance (RBAC, audit logging) without further review","Environments where local vault file access must be strictly minimized or isolated","Use cases requiring guaranteed backward/forward compatibility of the exposed tool contracts across versions without testing"],"best_when":"You want local/offline-style, AI tool access to your own Obsidian vault with graph traversal and semantic operations via MCP-compatible clients.","avoid_when":"You cannot safely expose vault access (write/edit) to an AI client, or you cannot validate/contain the MCP server’s HTTP exposure and credentials.","alternatives":["Use direct file access tooling (read-only) plus your own retrieval/indexing pipeline","RAG against an exported Obsidian vault using a dedicated vector database","Alternative MCP servers that provide vault-like note/search operations with tighter scopes"],"af_score":55.5,"security_score":48.5,"reliability_score":32.5,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:35:01.377160+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":"http://localhost:3001/mcp (also supports HTTPS on 3443 per README)","has_sdk":true,"sdk_languages":["TypeScript","JavaScript"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["API key via HTTP Authorization: Bearer <key>"],"oauth":false,"scopes":false,"notes":"README indicates an API key is used for the MCP server over HTTP headers. It does not clearly document fine-grained permissions/scopes at the client level."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information is provided in the supplied content; this appears to be a local/community plugin."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":55.5,"security_score":48.5,"reliability_score":32.5,"mcp_server_quality":78.0,"documentation_accuracy":65.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":80.0,"rate_limit_clarity":20.0,"tls_enforcement":70.0,"auth_strength":55.0,"scope_granularity":20.0,"dependency_hygiene":45.0,"secret_handling":50.0,"security_notes":"Based on provided documentation only: authentication is an API key sent via Authorization: Bearer header. README mentions HTTPS and 'Path validation and permissions' and a read-only mode, but the supplied content does not detail TLS enforcement behavior, credential storage, logging/telemetry redaction, authorization model granularity, or explicit rate-limiting. Given the plugin enables vault write/edit, additional validation of tool-level authorization and server exposure is important.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":40.0,"error_recovery":35.0,"idempotency_support":"false","idempotency_notes":"No information provided about idempotency semantics for edit/create operations.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Write/edit tools can modify vault content; use read-only mode when validating agent behavior","HTTP exposure of the local MCP server requires careful network binding and credential handling","Graph traversal and semantic search may be computationally heavy on large vaults; agents may need to limit traversal depth"]}}