Obsidian Enhanced

v1.0.0Knowledge & Memorystable

This is an enhanced version of the excellent cyanheads/obsidian-mcp-server with additional features specifically tailored for remote Claude.ai integration, advanced task querying, and security via Tailscale.

obsidian-mcp-server-enhancedmcpai-integration
Share:
31
Stars
0
Downloads
0
Weekly
0/5

What is Obsidian Enhanced?

Obsidian Enhanced is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this is an enhanced version of the excellent cyanheads/obsidian-mcp-server with additional features specifically tailored for remote claude.ai integration, advanced task querying, and security via tai...

This is an enhanced version of the excellent cyanheads/obsidian-mcp-server with additional features specifically tailored for remote Claude.ai integration, advanced task querying, and security via Tailscale.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • This is an enhanced version of the excellent cyanheads/obsid

Use Cases

Connect Claude.ai to Obsidian knowledge base remotely with Tailscale security.
Query and manage notes with advanced task querying capabilities.
Integrate personal knowledge management with remote AI assistants securely.
BoweyLou

Maintainer

LicenseApache 2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx obsidian-mcp-server-enhanced

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Obsidian Enhanced

Obsidian MCP Server Enhanced is an extended TypeScript MCP server that connects AI assistants to your Obsidian vault through the Local REST API plugin. Building on cyanheads/obsidian-mcp-server, it adds remote Claude.ai integration via Tailscale Funnel, multi-vault support, advanced task querying with date and priority filtering, Dataview DQL query execution, and an optional ChatGPT REST layer. With over 10 MCP tools covering file reading, writing, searching, tag management, and frontmatter editing, it turns your Obsidian knowledge base into a fully AI-accessible knowledge platform.

Prerequisites

  • Node.js v18 or higher installed
  • Obsidian desktop app with the Local REST API community plugin installed and enabled
  • API key from the Local REST API plugin settings panel in Obsidian
  • Tailscale installed and configured if you want remote Claude.ai access
  • An MCP-compatible client: Claude Desktop (local) or Claude.ai with Remote MCP (remote)
1

Install the Obsidian Local REST API plugin

In Obsidian, go to Settings > Community Plugins, search for 'Local REST API', install and enable it. Copy the API key shown in the plugin settings.

2

Clone and build the enhanced server

Clone the repository, install dependencies, and build the TypeScript project.

git clone https://github.com/BoweyLou/obsidian-mcp-server-enhanced.git
cd obsidian-mcp-server-enhanced
npm install
npm run build
3

Generate a remote authentication key (for remote access)

If you plan to use Claude.ai Remote MCP, generate a secure authentication key for the MCP_AUTH_KEY environment variable.

openssl rand -hex 32
4

Configure environment variables

Set the required environment variables for single-vault mode. For multi-vault mode, use OBSIDIAN_VAULTS with a JSON array of vault definitions instead.

5

Enable Tailscale Funnel for remote access (optional)

If using Claude.ai Remote MCP, start the server in HTTP mode and expose it through Tailscale Funnel on the configured port.

tailscale funnel 3010
6

Configure your MCP client

For local use, add the server to claude_desktop_config.json. For remote Claude.ai, add the Tailscale Funnel URL as a Remote MCP endpoint with your MCP_AUTH_KEY.

Obsidian Enhanced Examples

Client configuration

Add this to your claude_desktop_config.json for local single-vault mode. Replace values with your actual Obsidian API key and base URL from the Local REST API plugin.

{
  "mcpServers": {
    "obsidian-enhanced": {
      "command": "node",
      "args": ["/path/to/obsidian-mcp-server-enhanced/build/index.js"],
      "env": {
        "OBSIDIAN_API_KEY": "your-obsidian-local-rest-api-key",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "MCP_AUTH_KEY": "your-generated-auth-key"
      }
    }
  }
}

Prompts to try

Use these prompts with Claude to interact with your Obsidian vault through the enhanced MCP server.

- "Search my Obsidian vault for all notes mentioning 'project roadmap'"
- "Read the note at Projects/Q4-Planning.md from my vault"
- "List all incomplete tasks in my vault due this week"
- "Add a tag 'reviewed' to the note Daily/2024-01-15.md"
- "Run a Dataview query: TABLE file.mtime FROM \"Projects\" SORT file.mtime DESC"
- "Update the frontmatter of Meeting-Notes.md to set status: done"

Troubleshooting Obsidian Enhanced

Connection refused when the server tries to reach Obsidian

Ensure Obsidian is open and the Local REST API plugin is enabled. The default base URL is http://127.0.0.1:27123 — confirm this matches the port shown in the plugin settings.

Authentication error with OBSIDIAN_API_KEY

Open Obsidian Settings > Local REST API, copy the API key shown there, and paste it exactly into the OBSIDIAN_API_KEY environment variable. The key changes each time you regenerate it in the plugin.

Remote Claude.ai cannot connect via Tailscale Funnel

Confirm Tailscale Funnel is active ('tailscale funnel status') and set MCP_HTTP_STATELESS=true in your environment for stateless Claude.ai compatibility. The Remote MCP URL format is https://your-device.your-tailnet.ts.net/mcp?api_key=YOUR_MCP_AUTH_KEY.

Frequently Asked Questions about Obsidian Enhanced

What is Obsidian Enhanced?

Obsidian Enhanced is a Model Context Protocol (MCP) server that this is an enhanced version of the excellent cyanheads/obsidian-mcp-server with additional features specifically tailored for remote claude.ai integration, advanced task querying, and security via tailscale. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Obsidian Enhanced?

Follow the installation instructions on the Obsidian Enhanced GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Obsidian Enhanced?

Obsidian Enhanced works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Obsidian Enhanced free to use?

Yes, Obsidian Enhanced is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "obsidian-mcp-server-enhanced": { "command": "npx", "args": ["-y", "obsidian-mcp-server-enhanced"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Obsidian Enhanced?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides