Favicon of obsidian-mcp-server

obsidian-mcp-server

MCP ServerCode & Developer ToolsTypeScriptOpen source

obsidian-mcp-server is a TypeScript MCP server for Claude Desktop, Cursor, VS Code with npx, docker, git clone. Obsidian vaults MCP server - read, write, search, and surgically edit notes, tags, and frontmatter via the Local REST API plugin.

Decision snapshot

Is this a fit?

Best for

Connecting agents to external tools and data, Integrations workflows, Coding workflows, Data workflows

Works with

Claude Desktop, Cursor, VS Code, TypeScript, Node.js

Access

Credentials required authentication

Setup

npm, Local or self-hosted

Project health

4 months ago · Apache-2.0 license

Considerations

Requires OBSIDIAN_API_KEY. Requires OBSIDIAN_BASE_URL. Requires OBSIDIAN_VERIFY_SSL.

How to use obsidian-mcp-server

Install or run

npx -y obsidian-mcp-server

Client configuration

{
  "obsidian-mcp-server": {
    "command": "npx",
    "args": ["-y", "obsidian-mcp-server"],
    "env": {
      "MCP_TRANSPORT_TYPE": "stdio",
      "OBSIDIAN_API_KEY": "",
      "OBSIDIAN_BASE_URL": ""
    }
  }
}

Compatible clients

Claude DesktopCursorVS Code

What is obsidian-mcp-server?

obsidian-mcp-server is a TypeScript MCP server for Claude Desktop, Cursor, VS Code with npx, docker, git clone. Obsidian vaults MCP server - read, write, search, and surgically edit notes, tags, and frontmatter via the Local REST API plugin. This profile combines repository metadata with install, compatibility, and usage signals so developers can quickly decide whether it fits their agent workflow before opening the source repository.

Trust signal
80/100
Maintenance signal
75/100
Adoption signal
68/100

Automated repository signals based on public metadata such as recency, license, installation evidence, and adoption. These are not a security audit or endorsement. See how SkillIndex evaluates profiles.

Key capabilities

  • Tool access support
  • Shell commands support
  • Presentation work support
  • Document generation support
  • Anthropic provider support
  • package.json config support
  • Dockerfile config support

Compatibility and setup

Install or run obsidian-mcp-server using npx. Check cyanheads/obsidian-mcp-server for the latest setup command.

npmClaude DesktopCursorVS Codestdiostreamable-http
  • Built for TypeScript
  • Built for Node.js
  • Built for Docker
  • Install or run with npm
  • Works with Claude Desktop
  • Works with Cursor
  • Works with VS Code
  • Uses stdio transport

MCP metadata is retained with field-level source and confidence evidence. Undetected values remain unknown.

Requirements and access

OBSIDIAN_API_KEYOBSIDIAN_BASE_URLOBSIDIAN_VERIFY_SSLOBSIDIAN_REQUEST_TIMEOUT_MSOBSIDIAN_ENABLE_COMMANDSOBSIDIAN_READ_PATHSOBSIDIAN_WRITE_PATHSOBSIDIAN_READ_ONLYOBSIDIAN_OMNISEARCH_URLMCP_LOG_LEVELMCP_HTTP_HOSTMCP_HTTP_PORTMCP_HTTP_ENDPOINT_PATHMCP_AUTH_MODEAPI key requiredOAuthNetwork access

Security and permissions

Review permissions before connecting any MCP server to an agent. Pay special attention to whether it can read local files, write data, call external services, or perform destructive actions.

Credentials required authenticationLocal or self-hosted

When to use obsidian-mcp-server

  • Use it for connecting agents to external tools and data.
  • Use it for integrations workflows.
  • Use it for coding workflows.
  • Use it for data workflows.
  • Use it for claude desktop users.

Built with

TypeScriptNode.jsDockernpmClaude DesktopCursorVS Codestdiostreamable-http

Verified compatibility and discovery

Frequently asked questions

What is obsidian-mcp-server?

obsidian-mcp-server is a TypeScript MCP server for Claude Desktop, Cursor, VS Code with npm. Obsidian vaults MCP server - read, write, search, and surgically edit notes, tags, and frontmatter via the Local REST API plugin.

Who is obsidian-mcp-server best for?

obsidian-mcp-server is best for connecting agents to external tools and data, integrations workflows, coding workflows, data workflows, claude desktop users.

How do I install obsidian-mcp-server?

Install or run obsidian-mcp-server using npm. Check obsidian-mcp-server for the latest setup command.

Is obsidian-mcp-server actively maintained?

obsidian-mcp-server may need a closer maintenance check before production use.

Share:

Stars
538
Forks
81
Last commit
4 months ago
Last verified
Sep 4, 2026
Metadata fetched
Sep 4, 2026
Repository age
2 years
License
Apache-2.0

Project health auto-fetched from the source repository.

Maintain this resource?

Review this source-backed profile, send a correction with evidence, or link to it from your documentation. Claims verify your relationship to the project; profile facts still require source evidence and editorial review.

Alternatives to obsidian-mcp-server