MCP Obsidian vs Project MCP

A side-by-side look at the MCP Obsidian and Project MCP MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.

MCP Obsidian logoMCP ObsidianKnowledge & Memory · Local subprocess (stdio)MCP server that interacts with Obsidian via the Obsidian rest API community plugin48FairAuth: api key requiredProject MCP logoProject MCPKnowledge & Memory · Local subprocess (stdio)Intent-based search over a project's documentation and todo files for AI agents. Local stdio server.64GoodAuth: no auth required

Verdict: choose MCP Obsidian for knowledge & memory work as a local process; choose Project MCP for knowledge & memory as a local process. You can also run both side by side in one mcpServers block.

Which MCP server should you choose?

MCP Obsidian logoChoose MCP Obsidian when

  • You need dedicated capabilities in the Knowledge & Memory domain.
  • You prefer a local stdio subprocess transport.
  • Its auth model fits you: API key required.
  • You have the keys it needs: OBSIDIAN_API_KEY.
Explore MCP Obsidian

Project MCP logoChoose Project MCP when

  • You need dedicated capabilities in the Knowledge & Memory domain.
  • You prefer a local stdio subprocess transport.
  • Its auth model fits you: No auth required.
  • You want tools like search_project, search_docs, get_doc.
Explore Project MCP

Feature & specification comparison

Rows where the two servers differ are marked.

SpecMCP Obsidian logoMCP ObsidianProject MCP logoProject MCP
CategoryKnowledge & MemoryKnowledge & Memory
Quality signal48/100 · Fair64/100 · Good
Install commandConfirmedConfirmed
TransportLocal subprocess (stdio)Local subprocess (stdio)
AuthAPI key requiredNo auth required
PricingFreeFree
Required env varsOBSIDIAN_API_KEYNone listed
Verified ownerCommunity listingCommunity listing
GitHub stars4,4949
Directory activity 9 views 0 installs 0 upvotes 0 views 0 installs 0 upvotes
ToolsNot listed42

Tools & capabilities

MCP Obsidian tools

No tool names declared yet. Check the project README from the listing page.

Project MCP tools 42

  • search_projectSearch across project sources with smart intent detection. IMPORTANT: "project docs" means APPLICATION documentation (docs/ + DECISIONS.md), NOT project management. Use intent "project_docs" when user says "project docs/documents/documentation" to search application documentation. Use intent "plan" for project management (status, todos, roadmap, backlog).
  • search_docsSearch only the docs/ directory for reference documentation. Use this when the user specifically asks for "docs" or "documentation". Returns relevant documentation chunks with file paths and content snippets.
  • get_docGet the full content of a specific file. Supports files from .project/, root-level, or docs/. Use the path as returned from search results.
  • list_docsList all available documentation files organized by category. Use this to discover what documentation is available or to get an overview of the documentation structure.
  • get_doc_structureGet the complete documentation directory structure with file paths and descriptions. Useful for understanding the organization of documentation.
  • manage_project_fileSmart tool that automatically determines which project file to create or update based on context. Use this when making changes to the project - it will check project state and determine if index.md, ROADMAP.md, TODO.md, STATUS.md, or DECISIONS.md should be created/updated. This is the primary tool for managing project documentation during development.
  • check_project_stateChecks the current state of project management files. Returns which files exist (.project/index.md, ROADMAP.md, TODO.md, STATUS.md, DECISIONS.md) and provides a summary of project state. Use this before making changes to understand what exists.
  • create_or_update_roadmapCreates or updates the ROADMAP.md file in .project/ directory. Use this when planning future work, milestones, or phases. If the file exists, intelligently merges new content with existing roadmap.
  • create_or_update_todoCreates or updates the TODO.md file in .project/ directory. Use this when adding tasks, marking items complete, or updating task status. Intelligently organizes tasks into sections (In Progress, Next Up, Blocked, Completed).
  • create_or_update_statusCreates or updates the STATUS.md file in .project/ directory. Use this when updating project health, recent changes, metrics, or current phase. Automatically updates the "Last Updated" timestamp.
  • create_or_update_indexCreates or updates the index.md file in .project/ directory. This is the contract file that defines how agents should interpret sources. Use this when setting up project structure or updating source mappings.
  • create_or_update_decisionsCreates or updates the DECISIONS.md file in .project/ directory. Use this when documenting architecture decisions, trade-offs, or rationale. Helps maintain a decision log for the project.
  • +30 more on the listing page

Ready-to-paste client configs

Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.

MCP Obsidian

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "markuspfundstein-mcp-obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "YOUR_OBSIDIAN_API_KEY_HERE"
      }
    }
  }
}

Project MCP

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "project-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "project-mcp"
      ]
    }
  }
}

Frequently asked questions

MCP Obsidian is categorized under Knowledge & Memory and uses a local stdio subprocess. Project MCP belongs to Knowledge & Memory and uses a local stdio subprocess. Pick MCP Obsidian for knowledge & memory work and Project MCP for knowledge & memory.

Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.

MCP Obsidian is listed as free. Auth: api key required. Project MCP is listed as free. Auth: no auth required. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.

Yes. MCP clients support multiple servers: add markuspfundstein-mcp-obsidian and project-mcp as separate keys in the same mcpServers object, and your assistant will call tools from either one.

On AllMCPs, MCP Obsidian has a quality signal of 48/100 (Fair) with 9 views, 0 installs and 4,494 GitHub stars. Project MCP has 64/100 (Good) with 0 views, 0 installs and 9 GitHub stars.