[{"_1":2,"_435":-5,"_436":-5},"loaderData",{"_3":4,"_22":23,"_279":280},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",17738431,"membership","referenceId","0199bc04-05d7-7246-80ed-52d925746408","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":40,"_196":197,"_278":177},"availableLocales",[],"githubUser","locale",{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","A Model Context Protocol server that provides comprehensive access to Obsidian vaults with Claude.ai remote integration, Tailscale support, and advanced query capabilities.","name","Obsidian MCP Server - Enhanced","readme","# Obsidian MCP Server - Enhanced\n\n[![TypeScript](https://img.shields.io/badge/TypeScript-^5.8.3-blue.svg)](https://www.typescriptlang.org/)\n[![Model Context Protocol](https://img.shields.io/badge/MCP%20SDK-^1.12.1-green.svg)](https://modelcontextprotocol.io/)\n[![Version](https://img.shields.io/badge/Version-2.1.0-blue.svg)](./CHANGELOG.md)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Status](https://img.shields.io/badge/Status-Enhanced-brightgreen.svg)](https://github.com/BoweyLou/obsidian-mcp-server-enhanced/issues)\n[![Original](https://img.shields.io/badge/Fork%20of-cyanheads/obsidian--mcp--server-blue.svg)](https://github.com/cyanheads/obsidian-mcp-server)\n\n**Enhanced Obsidian MCP Server with Claude.ai Remote Integration, Tailscale Support, and Advanced Query Capabilities!**\n\n> **🔥 Enhanced Fork Notice:** This is an enhanced version of the excellent [cyanheads/obsidian-mcp-server](https://github.com/cyanheads/obsidian-mcp-server) with additional features specifically tailored for remote Claude.ai integration, advanced task querying, and security via Tailscale.\n\nAn MCP (Model Context Protocol) server providing comprehensive access to your Obsidian vault. Enables LLMs and AI agents to read, write, search, and manage your notes and files through the [Obsidian Local REST API plugin](https://github.com/coddingtonbear/obsidian-local-rest-api).\n\nBuilt on the [`cyanheads/mcp-ts-template`](https://github.com/cyanheads/mcp-ts-template), this server follows a modular architecture with robust error handling, logging, and security features.\n\n## 🚀 Enhanced Features (This Fork)\n\n### 🏛️ **Multi-Vault Support**\nSimultaneous access to multiple Obsidian vaults through a single MCP server:\n- **Multiple Vault Management**: Connect to multiple Obsidian instances on different ports simultaneously\n- **Vault-Specific Routing**: Tools automatically route to the correct vault based on `vault` parameter\n- **Individual Authentication**: Separate API keys for each vault with centralized MCP authentication\n- **Backwards Compatible**: Existing single-vault configurations continue to work unchanged\n- **Dynamic Configuration**: JSON-based vault configuration with validation and error handling\n\n### 🌐 **Claude.ai Remote Integration**\nPerfect integration with Claude.ai's Remote MCP feature:\n- **Stateless HTTP Mode**: Dedicated stateless transport for Claude.ai compatibility (`MCP_HTTP_STATELESS=true`)\n- **Session-Based Mode**: Traditional session management for other MCP clients\n- **Simplified Authentication**: Uses dedicated MCP_AUTH_KEY for server access\n- **Zero Configuration**: Works out-of-the-box with Claude.ai Remote MCP servers\n- **Production Ready**: Enterprise-grade stability and error handling\n\n### 🔒 **Tailscale Secure Remote Access**\nAccess your Obsidian vault securely from anywhere:\n- **Tailscale Funnel Integration**: Secure HTTPS endpoints with automatic certificates\n- **End-to-End Encryption**: All traffic encrypted through Tailscale network\n- **No Port Forwarding**: Zero network configuration required\n- **Access Control**: Built-in Tailscale ACL support for enterprise security\n\n### 📊 **Enhanced Task & Query System**\nAdvanced querying capabilities beyond the original:\n- **Tasks Plugin Integration**: Deep integration with Obsidian Tasks plugin\n- **Advanced Date Parsing**: Natural language date recognition\n- **Priority Detection**: Visual and text-based priority parsing\n- **Multiple Output Formats**: Table, list, and summary views\n\n### 🔧 **Production Monitoring & Reliability**\nEnterprise-grade monitoring and auto-restart capabilities:\n- **Health Check Script**: Comprehensive component validation (`scripts/health-check.sh`)\n- **Intelligent Monitoring**: Auto-restart with process lifecycle management (`scripts/monitor-mcp.sh`)\n- **macOS Auto-Start**: Launch agent configuration for system startup (`scripts/setup-autostart.sh`)\n- **Dynamic Port Management**: Automatic port conflict resolution (3010-3013 range)\n- **Enhanced Logging**: Detailed connection debugging and API key validation\n\n\n## 🚀 Core Capabilities: Obsidian Tools 🛠️\n\nThis server equips your AI with specialized tools to interact with your Obsidian vault:\n\n| Tool Name | Description | Key Features |\n| :------------------------------------------------------------------------------------- | :-------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [`obsidian_read_file`](./src/mcp-server/tools/obsidianReadFileTool/) | Retrieves the content and metadata of a specified file. | - Read in `markdown` or `json` format.
- Case-insensitive path fallback.
- Includes file stats (creation/modification time). |\n| [`obsidian_update_file`](./src/mcp-server/tools/obsidianUpdateFileTool/) | Modifies notes using whole-file operations. | - `append`, `prepend`, or `overwrite` content.
- Can create files if they don't exist.
- Targets files by path, active note, or periodic note. |\n| [`obsidian_search_replace`](./src/mcp-server/tools/obsidianSearchReplaceTool/) | Performs search-and-replace operations within a target note. | - Supports string or regex search.
- Options for case sensitivity, whole word, and replacing all occurrences. |\n| [`obsidian_global_search`](./src/mcp-server/tools/obsidianGlobalSearchTool/) | Performs a search across the entire vault. | - Text or regex search.
- Filter by path and modification date.
- Paginated results. |\n| [`obsidian_list_files`](./src/mcp-server/tools/obsidianListFilesTool/) | Lists files and subdirectories within a specified vault folder. | - Filter by file extension or name regex.
- Provides a formatted tree view of the directory. |\n| [`obsidian_manage_frontmatter`](./src/mcp-server/tools/obsidianManageFrontmatterTool/) | Atomically manages a note's YAML frontmatter. | - `get`, `set`, or `delete` frontmatter keys.
- Avoids rewriting the entire file for metadata changes. |\n| [`obsidian_manage_tags`](./src/mcp-server/tools/obsidianManageTagsTool/) | Adds, removes, or lists tags for a note. | - Manages tags in both YAML frontmatter and inline content. |\n| [`obsidian_delete_file`](./src/mcp-server/tools/obsidianDeleteFileTool/) | Permanently deletes a specified file from the vault. | - Case-insensitive path fallback for safety. |\n| [`obsidian_dataview_query`](./src/mcp-server/tools/obsidianDataviewQueryTool/) | Execute Dataview DQL queries against your vault. | - Run TABLE, LIST queries using Dataview syntax.
- Query notes by tags, frontmatter, dates.
- Generate reports and analytics. |\n| [`obsidian_task_query`](./src/mcp-server/tools/obsidianTaskQueryTool/) | Search and analyze tasks across your vault. | - Filter by status, date ranges, priorities.
- Multiple output formats.
- Extract task metadata (due dates, tags). |\n\n---\n\n## Table of Contents\n\n| [Overview](#overview) | [Features](#features) | [Installation](#installation) |\n| [Configuration](#configuration) | [Project Structure](#project-structure) | [Vault Cache Service](#vault-cache-service) |\n| [Tools](#tools) | [Resources](#resources) | [Development](#development) | [License](#license) |\n\n## Overview\n\nThe Obsidian MCP Server acts as a bridge, allowing applications (MCP Clients) that understand the Model Context Protocol (MCP) – like advanced AI assistants (LLMs), IDE extensions, or custom scripts – to interact directly and safely with your Obsidian vault.\n\nInstead of complex scripting or manual interaction, your tools can leverage this server to:\n\n- **Automate vault management**: Read notes, update content, manage frontmatter and tags, search across files, list directories, and delete files programmatically.\n- **Integrate Obsidian into AI workflows**: Enable LLMs to access and modify your knowledge base as part of their research, writing, or coding tasks.\n- **Build custom Obsidian tools**: Create external applications that interact with your vault data in novel ways.\n\nBuilt on the robust `mcp-ts-template`, this server provides a standardized, secure, and efficient way to expose Obsidian functionality via the MCP standard. It achieves this by communicating with the powerful [Obsidian Local REST API plugin](https://github.com/coddingtonbear/obsidian-local-rest-api) running inside your vault.\n\n> **Developer Note**: This repository includes a [.clinerules](.clinerules) file that serves as a developer cheat sheet for your LLM coding agent with quick reference for the codebase patterns, file locations, and code snippets.\n\n## Features\n\n### Core Utilities\n\nLeverages the robust utilities provided by the `mcp-ts-template`:\n\n- **Logging**: Structured, configurable logging (file rotation, console, MCP notifications) with sensitive data redaction.\n- **Error Handling**: Centralized error processing, standardized error types (`McpError`), and automatic logging.\n- **Configuration**: Environment variable loading (`dotenv`) with comprehensive validation.\n- **Input Validation/Sanitization**: Uses `zod` for schema validation and custom sanitization logic.\n- **Request Context**: Tracking and correlation of operations via unique request IDs.\n- **Type Safety**: Strong typing enforced by TypeScript and Zod schemas.\n- **HTTP Transport Option**: Native Node.js HTTP server with session management, CORS support, and API key authentication.\n\n### Obsidian Integration\n\n- **Obsidian Local REST API Integration**: Communicates directly with the Obsidian Local REST API plugin via HTTP requests managed by the `ObsidianRestApiService`.\n- **Comprehensive Command Coverage**: Exposes key vault operations as MCP tools (see [Tools](#tools) section).\n- **Vault Interaction**: Supports reading, updating (append, prepend, overwrite), searching (global text/regex, search/replace), listing, deleting, and managing frontmatter and tags.\n- **Targeting Flexibility**: Tools can target files by path, the currently active file in Obsidian, or periodic notes (daily, weekly, etc.).\n- **Vault Cache Service**: An intelligent in-memory cache that improves performance and resilience. It caches vault content, provides a fallback for the global search tool if the live API fails, and periodically refreshes to stay in sync.\n- **Safety Features**: Case-insensitive path fallbacks for file operations, clear distinction between modification types (append, overwrite, etc.).\n\n## Installation\n\n### Prerequisites\n\n1. **Obsidian**: You need Obsidian installed.\n2. **Obsidian Local REST API Plugin**: Install and enable the [Obsidian Local REST API plugin](https://github.com/coddingtonbear/obsidian-local-rest-api) within your Obsidian vault.\n3. **API Key**: Configure an API key within the Local REST API plugin settings in Obsidian. You will need this key to configure the server.\n4. **Node.js & npm**: Ensure you have Node.js (v18 or later recommended) and npm installed.\n5. **Tailscale** (for remote access): Install [Tailscale](https://tailscale.com) and enable Tailscale Funnel for secure remote Claude.ai integration.\n\n> **💡 Quick Setup**: For automatic startup on boot, see the [Auto-Start Setup Guide](./scripts/autostart/README.md) after installation.\n\n### Installation\n\n1. Clone this enhanced repository:\n ```bash\n git clone https://github.com/BoweyLou/obsidian-mcp-server-enhanced.git\n cd obsidian-mcp-server-enhanced\n ```\n2. Install dependencies:\n ```bash\n npm install\n ```\n3. Build the project:\n ```bash\n npm run build\n ```\n This compiles the TypeScript code to JavaScript in the `dist/` directory and makes the entry point executable.\n\n## Configuration\n\n### Environment Variables\n\nConfigure the server using environment variables.\n\nThese variables must be set in the MCP client configuration (e.g., `cline_mcp_settings.json`) or in your environment before starting the server (if running directly).\n\nIf running directly, they can be set in a `.env` file in the project root or directly in your environment.\n\n| Variable | Description | Required | Default |\n| :------------------------------------ | :-------------------------------------------------------- | :---------------- | :----------------------- |\n| **`MCP_AUTH_KEY`** | Authentication key for Claude.ai Remote MCP access. Generate with `openssl rand -hex 32` | **Yes** (Remote) | `undefined` |\n| **`OBSIDIAN_VAULTS`** | JSON array of vault configurations for multi-vault mode. | **Yes** (Multi) | `undefined` |\n| **`OBSIDIAN_API_KEY`** | API Key from Obsidian plugin (single-vault mode only). | **Yes** (Single) | `undefined` |\n| **`OBSIDIAN_BASE_URL`** | Base URL of Obsidian API (single-vault mode only). | **Yes** (Single) | `http://127.0.0.1:27123` |\n| `MCP_TRANSPORT_TYPE` | Server transport: `stdio` or `http`. | No | `http` |\n| `MCP_HTTP_PORT` | Port for the HTTP server. | No | `3010` |\n| `MCP_HTTP_HOST` | Host for the HTTP server. | No | `127.0.0.1` |\n| `MCP_HTTP_STATELESS` | Enable stateless mode for Claude.ai compatibility. | No | `false` |\n| `MCP_ALLOWED_ORIGINS` | Comma-separated origins for CORS. **Set for production.** | No | (none) |\n| `MCP_LOG_LEVEL` | Logging level (`debug`, `info`, `error`, etc.). | No | `info` |\n| `OBSIDIAN_VERIFY_SSL` | Set to `false` to disable SSL verification. | No | `true` |\n| `OBSIDIAN_ENABLE_CACHE` | Set to `true` to enable the in-memory vault cache. | No | `true` |\n| `OBSIDIAN_CACHE_REFRESH_INTERVAL_MIN` | Refresh interval for the vault cache in minutes. | No | `10` |\n\n### Multi-Vault Configuration\n\nThe server supports both single-vault (backwards compatible) and multi-vault modes:\n\n#### Single-Vault Mode (Legacy)\n```bash\n# .env file\nMCP_AUTH_KEY=your-generated-mcp-auth-key\nOBSIDIAN_API_KEY=your-obsidian-plugin-api-key\nOBSIDIAN_BASE_URL=http://127.0.0.1:27123\nMCP_TRANSPORT_TYPE=http\nMCP_HTTP_STATELESS=true\n```\n\n#### Multi-Vault Mode (Recommended)\n```bash\n# .env file\nMCP_AUTH_KEY=your-generated-mcp-auth-key\nOBSIDIAN_VAULTS='[\n {\n \"id\": \"work\",\n \"name\": \"Work Vault\", \n \"apiKey\": \"work-vault-api-key\",\n \"baseUrl\": \"http://127.0.0.1:27123\",\n \"verifySsl\": false\n },\n {\n \"id\": \"personal\",\n \"name\": \"Personal Vault\",\n \"apiKey\": \"personal-vault-api-key\", \n \"baseUrl\": \"http://127.0.0.1:27122\",\n \"verifySsl\": false\n }\n]'\nMCP_TRANSPORT_TYPE=http\nMCP_HTTP_STATELESS=true\n```\n\n#### Setup Process\n1. **Generate MCP Auth Key**: `openssl rand -hex 32`\n2. **Configure Multiple Obsidian Instances**: Install Local REST API plugin on different ports\n3. **Get API Keys**: Extract API keys from each Obsidian instance's plugin settings\n4. **Configure Vaults**: Update `.env` with `OBSIDIAN_VAULTS` JSON configuration\n5. **Start Server**: `npm run start:http`\n6. **Access via Claude.ai**: Use your Tailscale URL with MCP_AUTH_KEY\n\n### Connecting to the Obsidian API\n\n#### Single-Vault Mode\nTo connect in single-vault mode, configure the base URL (`OBSIDIAN_BASE_URL`) and API key (`OBSIDIAN_API_KEY`). The Obsidian Local REST API plugin offers two connection types:\n\n1. **Encrypted (HTTPS)**:\n - Uses secure `https://` endpoint (e.g., `https://127.0.0.1:27124`)\n - Requires `OBSIDIAN_VERIFY_SSL=false` for self-signed certificates\n\n2. **Non-encrypted (HTTP) - Recommended**:\n - Uses `http://` endpoint (e.g., `http://127.0.0.1:27123`)\n - Simpler setup, no SSL verification needed\n\n#### Multi-Vault Mode\nFor multi-vault mode, configure each vault individually in the `OBSIDIAN_VAULTS` JSON array with its own API key and base URL. Each vault can use either HTTP or HTTPS as needed.\n\n**Example configurations:**\n\n_Single-vault with HTTP:_\n```json\n\"env\": {\n \"MCP_AUTH_KEY\": \"your-generated-mcp-auth-key\",\n \"OBSIDIAN_API_KEY\": \"your-obsidian-api-key\",\n \"OBSIDIAN_BASE_URL\": \"http://127.0.0.1:27123\"\n}\n```\n\n_Multi-vault configuration:_\n```json\n\"env\": {\n \"MCP_AUTH_KEY\": \"your-generated-mcp-auth-key\",\n \"OBSIDIAN_VAULTS\": \"[{\\\"id\\\":\\\"work\\\",\\\"name\\\":\\\"Work\\\",\\\"apiKey\\\":\\\"work-key\\\",\\\"baseUrl\\\":\\\"http://127.0.0.1:27123\\\"},{\\\"id\\\":\\\"personal\\\",\\\"name\\\":\\\"Personal\\\",\\\"apiKey\\\":\\\"personal-key\\\",\\\"baseUrl\\\":\\\"http://127.0.0.1:27122\\\"}]\"\n}\n```\n\n### Local MCP Client Settings (Optional)\n\n> **Note**: For Claude.ai Remote MCP integration, skip this section and use the [Tailscale Remote Access Setup](#-remote-access-setup-tailscale) instead.\n\nFor local MCP clients (e.g., Cline), add to your settings (e.g., `cline_mcp_settings.json`):\n\n**Single-vault configuration:**\n```json\n{\n \"mcpServers\": {\n \"obsidian-mcp-server\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/your/obsidian-mcp-server-enhanced/dist/index.js\"],\n \"env\": {\n \"MCP_AUTH_KEY\": \"your-generated-mcp-auth-key\",\n \"OBSIDIAN_API_KEY\": \"your-obsidian-api-key\",\n \"OBSIDIAN_BASE_URL\": \"http://127.0.0.1:27123\",\n \"OBSIDIAN_ENABLE_CACHE\": \"true\"\n }\n }\n }\n}\n```\n\n**Multi-vault configuration:**\n```json\n{\n \"mcpServers\": {\n \"obsidian-mcp-server\": {\n \"command\": \"node\",\n \"args\": [\"/path/to/your/obsidian-mcp-server-enhanced/dist/index.js\"],\n \"env\": {\n \"MCP_AUTH_KEY\": \"your-generated-mcp-auth-key\",\n \"OBSIDIAN_VAULTS\": \"[{\\\"id\\\":\\\"work\\\",\\\"name\\\":\\\"Work Vault\\\",\\\"apiKey\\\":\\\"work-api-key\\\",\\\"baseUrl\\\":\\\"http://127.0.0.1:27123\\\"},{\\\"id\\\":\\\"personal\\\",\\\"name\\\":\\\"Personal Vault\\\",\\\"apiKey\\\":\\\"personal-api-key\\\",\\\"baseUrl\\\":\\\"http://127.0.0.1:27122\\\"}]\",\n \"OBSIDIAN_ENABLE_CACHE\": \"true\"\n }\n }\n }\n}\n```\n\n## 🌐 Remote Access Setup (Tailscale)\n\nFor remote access to your Obsidian vault from anywhere, you can use Tailscale to securely expose your MCP server over the internet.\n\n### Prerequisites\n\n1. **Tailscale Account**: Sign up at [tailscale.com](https://tailscale.com)\n2. **Tailscale Installed**: Install Tailscale on your machine running the MCP server\n3. **Tailscale Funnel Enabled**: Enable Tailscale Funnel for your account\n\n### Setup Steps\n\n1. **Generate MCP Auth Key**:\n ```bash\n openssl rand -hex 32\n ```\n\n2. **Configure Environment**: Set up your `.env` file with the generated key:\n ```bash\n MCP_AUTH_KEY=your-generated-auth-key\n MCP_TRANSPORT_TYPE=http\n MCP_HTTP_PORT=3010\n MCP_HTTP_STATELESS=true\n ```\n\n3. **Configure Vaults**: Set up single or multi-vault configuration (see [Multi-Vault Configuration](#multi-vault-configuration))\n\n4. **Start the MCP Server**: \n ```bash\n npm run build && npm run start:http\n ```\n\n5. **Enable Tailscale Funnel**:\n ```bash\n tailscale funnel 3010\n ```\n\n6. **Get Your Public URL**: Check your Tailscale device URL:\n ```bash\n tailscale status --self | grep \"Funnel on\"\n ```\n\n### Claude.ai Remote MCP Configuration\n\nAdd to your Claude.ai Remote MCP servers using your MCP authentication key:\n\n**Single-vault setup:**\n```json\n{\n \"url\": \"https://your-device.your-tailnet.ts.net/mcp?api_key=your-mcp-auth-key\",\n \"name\": \"Obsidian Vault\"\n}\n```\n\n**Multi-vault setup:**\n```json\n{\n \"url\": \"https://your-device.your-tailnet.ts.net/mcp?api_key=your-mcp-auth-key\",\n \"name\": \"Obsidian Multi-Vault\"\n}\n```\n\n> **Authentication Note**: Claude.ai Remote MCP uses the `MCP_AUTH_KEY` for server authentication. Individual vault operations use the vault-specific API keys configured in your environment.\n\n### Security Considerations\n\n- **Dual Authentication**: MCP server authentication via MCP_AUTH_KEY, vault authentication via individual API keys\n- **Tailscale Encryption**: All traffic is encrypted end-to-end by Tailscale\n- **Private Network**: Only you can access the server through your Tailscale network\n- **Automatic SSL**: Tailscale Funnel provides automatic HTTPS certificates\n- **Vault Isolation**: Each vault uses its own API key for secure access control\n\n### Example Usage\n\nOnce set up, you can use tools remotely from Claude.ai:\n\n**Single-vault commands (uses default vault):**\n```\nUse obsidian_task_query to show me tasks due today with format=\"table\"\n```\n\n**Multi-vault commands (specify vault):**\n```\nUse obsidian_task_query with vault=\"work\" to show me work tasks due today\n```\n\n```\nUse obsidian_read_file with filePath=\"daily-note.md\" and vault=\"personal\" \n```\n\n```\nUse obsidian_dataview_query with vault=\"work\" to run: TABLE file.name FROM #meeting WHERE file.cday = date(today)\n```\n\n> **🚀 Pro Tip**: For production use, set up [automatic startup on boot](./scripts/autostart/README.md) so your server and Tailscale Funnel start automatically without manual intervention.\n\n## Project Structure\n\nThe codebase follows a modular structure within the `src/` directory:\n\n```\nsrc/\n├── index.ts # Entry point: Initializes and starts the server\n├── config/ # Configuration loading (env vars, package info)\n│ └── index.ts\n├── mcp-server/ # Core MCP server logic and capability registration\n│ ├── server.ts # Server setup, transport handling, tool/resource registration\n│ ├── resources/ # MCP Resource implementations (currently none)\n│ ├── tools/ # MCP Tool implementations (subdirs per tool)\n│ └── transports/ # Stdio and HTTP transport logic, auth middleware\n├── services/ # Abstractions for external APIs or internal caching\n│ ├── obsidianRestAPI/ # Typed client for Obsidian Local REST API\n│ └── vaultManager/ # Multi-vault configuration and service management\n├── types-global/ # Shared TypeScript type definitions (errors, etc.)\n└── utils/ # Common utility functions (logger, error handler, security, etc.)\n```\n\nFor a detailed file tree, run `npm run tree` or see [docs/tree.md](docs/tree.md).\n\n## Vault Cache Service\n\nThis server includes an intelligent **in-memory cache** designed to enhance performance and resilience when interacting with your vault.\n\n### Purpose and Benefits\n\n- **Performance**: By caching file content and metadata, the server can perform search operations much faster, especially in large vaults. This reduces the number of direct requests to the Obsidian Local REST API, resulting in a snappier experience.\n- **Resilience**: The cache acts as a fallback for the `obsidian_global_search` tool. If the live API search fails or times out, the server seamlessly uses the cache to provide results, ensuring that search functionality remains available even if the Obsidian API is temporarily unresponsive.\n- **Efficiency**: The cache is designed to be efficient. It performs an initial build on startup and then periodically refreshes in the background by checking for file modifications, ensuring it stays reasonably up-to-date without constant, heavy API polling.\n\n### How It Works\n\n1. **Initialization**: When enabled, the `VaultCacheService` builds an in-memory map of all `.md` files in your vault, storing their content and modification times.\n2. **Periodic Refresh**: The cache automatically refreshes at a configurable interval (defaulting to 10 minutes). During a refresh, it only fetches content for files that are new or have been modified since the last check.\n3. **Proactive Updates**: After a file is modified through a tool like `obsidian_update_file`, the service proactively updates the cache for that specific file, ensuring immediate consistency.\n4. **Search Fallback**: The `obsidian_global_search` tool first attempts a live API search. If this fails, it automatically falls back to searching the in-memory cache.\n\n### Configuration\n\nThe cache is enabled by default but can be configured via environment variables:\n\n- **`OBSIDIAN_ENABLE_CACHE`**: Set to `true` (default) or `false` to enable or disable the cache service.\n- **`OBSIDIAN_CACHE_REFRESH_INTERVAL_MIN`**: Defines the interval in minutes for the periodic background refresh. Defaults to `10`.\n\n## Tools\n\nThe Obsidian MCP Server provides a suite of tools for interacting with your vault(s), callable via the Model Context Protocol.\n\n### Multi-Vault Support\nAll tools support an optional `vault` parameter to specify which vault to operate on:\n- **Default Behavior**: Without `vault` parameter, tools use the first configured vault\n- **Specific Vault**: Add `vault: \"vault-id\"` to target a specific vault\n- **Example**: `obsidian_read_file(filePath=\"note.md\", vault=\"work\")`\n\n| Tool Name | Description | Key Arguments |\n| :---------------------------- | :-------------------------------------------------------- | :--------------------------------------------------------------- |\n| `obsidian_read_file` | Retrieves the content and metadata of a file. | `filePath`, `vault?`, `format?`, `includeStat?` |\n| `obsidian_update_file` | Modifies a file by appending, prepending, or overwriting. | `targetType`, `content`, `vault?`, `targetIdentifier?`, `wholeFileMode` |\n| `obsidian_search_replace` | Performs search-and-replace operations in a note. | `targetType`, `replacements`, `vault?`, `useRegex?`, `replaceAll?` |\n| `obsidian_global_search` | Searches the entire vault for content. | `query`, `vault?`, `searchInPath?`, `useRegex?`, `page?`, `pageSize?` |\n| `obsidian_list_files` | Lists files and subdirectories in a folder. | `dirPath`, `vault?`, `fileExtensionFilter?`, `nameRegexFilter?` |\n| `obsidian_manage_frontmatter` | Gets, sets, or deletes keys in a note's frontmatter. | `filePath`, `operation`, `key`, `vault?`, `value?` |\n| `obsidian_manage_tags` | Adds, removes, or lists tags in a note. | `filePath`, `operation`, `tags`, `vault?` |\n| `obsidian_delete_file` | Permanently deletes a file from the vault. | `filePath`, `vault?` |\n| `obsidian_dataview_query` | Execute Dataview DQL queries against your vault. | `query`, `vault?`, `format?` |\n| `obsidian_task_query` | Search and analyze tasks across your vault. | `vault?`, `status?`, `dateRange?`, `folder?`, `priority?`, `format?` |\n| `obsidian_periodic_notes` | Create and manage daily, weekly, monthly, yearly notes. | `operation`, `periodType`, `vault?`, `date?`, `content?`, `append?` |\n| `obsidian_block_reference` | Work with block references and heading operations. | `operation`, `filePath`, `vault?`, `heading?`, `content?`, `blockId?` |\n| `obsidian_graph_analysis` | Analyze note connections and vault relationships. | `operation`, `vault?`, `filePath?`, `minConnections?`, `maxDepth?` |\n| `obsidian_template_system` | Create files from templates with variable substitution. | `operation`, `vault?`, `templatePath?`, `targetPath?`, `variables?` |\n| `obsidian_smart_linking` | Get intelligent link suggestions and recommendations. | `operation`, `vault?`, `filePath?`, `content?`, `maxSuggestions?` |\n\n_Note: All tools support comprehensive error handling, multi-vault routing, and return structured JSON responses._\n\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\n## Attribution\n\nThis enhanced version is based on the excellent work by [cyanheads](https://github.com/cyanheads) in the original [obsidian-mcp-server](https://github.com/cyanheads/obsidian-mcp-server) project. All core functionality and architecture credit goes to the original author.\n\n**Enhancements in this fork:**\n- **Multi-Vault Support**: Simultaneous access to multiple Obsidian vaults with vault-specific routing\n- Claude.ai Remote MCP integration and compatibility fixes\n- Tailscale Funnel integration for secure remote access\n- Enhanced HTTP transport layer with authentication separation (MCP_AUTH_KEY)\n- Advanced task querying with Tasks plugin integration\n- **5 New Advanced Tools**: Periodic notes, block references, graph analysis, template system, and smart linking\n- Production-ready configuration for enterprise use\n\n---\n\n

\nBuilt with the Model Context Protocol
\nEnhanced for Claude.ai Remote Integration\n

\n","English","tag","en-US",{"_41":42,"_13":43,"_51":32,"_52":32,"_16":53,"_54":55,"_33":34,"_88":89,"_96":-5,"_97":-5,"_98":99,"_184":185,"_190":-5,"_62":165,"_191":192,"_65":193,"_194":195},"addedAt","2025-06-23T21:03:30.846180Z",[44,45,46,47,48,49,50],"category:note-taking","category:developer-tools","environment:local","environment:network","hosting:hybrid","language:typescript","license_grade:a","descriptionMarkdown","descriptionPlainText",8246,"integrations",[56,67,74,81],{"_57":58,"_31":64,"_65":66},"brand",{"_59":60,"_33":61,"_62":63},"logoSvgPath","M24 0v24H0V0h24ZM10.933 15.89H6.84v5.52h4.198v-.93H7.955v-1.503h2.77v-.93h-2.77v-1.224h2.978v-.934Zm2.146 0h-1.084v5.52h1.035v-3.6l2.226 3.6h1.118v-5.52h-1.036v3.686l-2.259-3.687Zm5.117 0h-1.208l1.973 5.52h1.19l1.976-5.52h-1.182l-1.352 4.085-1.397-4.086ZM5.4 19.68H3.72v1.68H5.4v-1.68Z",".ENV","slug","dotenv","Supports environment variable loading through dotenv for server configuration.","uid","00pzded0vl",{"_57":68,"_31":72,"_65":73},{"_59":69,"_33":70,"_62":71},"M19.355 18.538a68.967 68.959 0 0 0 1.858-2.954.81.81 0 0 0-.062-.9c-.516-.685-1.504-2.075-2.042-3.362-.553-1.321-.636-3.375-.64-4.377a1.707 1.707 0 0 0-.358-1.05l-3.198-4.064a3.744 3.744 0 0 1-.076.543c-.106.503-.307 1.004-.536 1.5-.134.29-.29.6-.446.914l-.31.626c-.516 1.068-.997 2.227-1.132 3.59-.124 1.26.046 2.73.815 4.481.128.011.257.025.386.044a6.363 6.363 0 0 1 3.326 1.505c.916.79 1.744 1.922 2.415 3.5zM8.199 22.569c.073.012.146.02.22.02.78.024 2.095.092 3.16.29.87.16 2.593.64 4.01 1.055 1.083.316 2.198-.548 2.355-1.664.114-.814.33-1.735.725-2.58l-.01.005c-.67-1.87-1.522-3.078-2.416-3.849a5.295 5.295 0 0 0-2.778-1.257c-1.54-.216-2.952.19-3.84.45.532 2.218.368 4.829-1.425 7.531zM5.533 9.938c-.023.1-.056.197-.098.29L2.82 16.059a1.602 1.602 0 0 0 .313 1.772l4.116 4.24c2.103-3.101 1.796-6.02.836-8.3-.728-1.73-1.832-3.081-2.55-3.831zM9.32 14.01c.615-.183 1.606-.465 2.745-.534-.683-1.725-.848-3.233-.716-4.577.154-1.552.7-2.847 1.235-3.95.113-.235.223-.454.328-.664.149-.297.288-.577.419-.86.217-.47.379-.885.46-1.27.08-.38.08-.72-.014-1.043-.095-.325-.297-.675-.68-1.06a1.6 1.6 0 0 0-1.475.36l-4.95 4.452a1.602 1.602 0 0 0-.513.952l-.427 2.83c.672.59 2.328 2.316 3.335 4.711.09.21.175.43.253.653z","Obsidian","obsidian","Provides comprehensive access to Obsidian vaults with tools for reading, writing, searching, and managing notes. Enables file operations, frontmatter management, tag operations, and Dataview query execution.","54ycydq0p4",{"_57":75,"_31":79,"_65":80},{"_59":76,"_33":77,"_62":78},"M24 12a3 3 0 1 1-6 0 3 3 0 0 1 6 0zm-9 9a3 3 0 1 1-6 0 3 3 0 0 1 6 0zm0-9a3 3 0 1 1-6 0 3 3 0 0 1 6 0zm6-6a3 3 0 1 1 0-6 3 3 0 0 1 0 6zm0-.5a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5zM3 24a3 3 0 1 1 0-6 3 3 0 0 1 0 6zm0-.5a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5zm18 .5a3 3 0 1 1 0-6 3 3 0 0 1 0 6zm0-.5a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5zM6 12a3 3 0 1 1-6 0 3 3 0 0 1 6 0zm9-9a3 3 0 1 1-6 0 3 3 0 0 1 6 0zm-3 2.5a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5zM6 3a3 3 0 1 1-6 0 3 3 0 0 1 6 0zM3 5.5a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5z","Tailscale","tailscale","Enables secure remote access to Obsidian vaults through Tailscale Funnel with end-to-end encryption, automatic HTTPS certificates, and no port forwarding requirements.","32oy3x58sy",{"_57":82,"_31":86,"_65":87},{"_59":83,"_33":84,"_62":85},"M19.088 2.477 24 7.606 12.521 20.485l-.925 1.038L0 7.559l5.108-5.082h13.98Zm-17.434 5.2 6.934-4.003H5.601L1.619 7.636l.035.041Zm12.117-4.003L3.333 9.7l2.149 2.588 10.809-6.241-.2-.346 2.851-1.646-.365-.381h-4.806Zm7.52 2.834L8.257 14.034h5.101v-.4h3.667l5.346-5.998-1.08-1.128Zm-7.129 10.338H9.268l2.36 2.843 2.534-2.843Z","Zod","zod","Uses Zod for schema validation and custom sanitization logic in MCP server operations.","q6fr827db8","namespace",{"_90":91,"_62":95},"owner",{"_92":93},"githubAccount",{"_94":95},"login","BoweyLou","readmeMarkdown","redditPostExternalId","repository",{"_100":101,"_150":151,"_154":155,"_175":-5,"_176":177,"_178":179,"_183":-5},"argumentsJsonSchema",{"_102":103,"_147":148,"_109":149},"properties",{"_104":105,"_111":112,"_115":116,"_119":120,"_122":123,"_126":127,"_130":131,"_133":134,"_136":137,"_140":141,"_143":144},"MCP_HTTP_HOST",{"_106":107,"_31":108,"_109":110},"default","127.0.0.1","Host for the HTTP server","type","string","MCP_HTTP_PORT",{"_106":113,"_31":114,"_109":110},"3010","Port for the HTTP server","MCP_LOG_LEVEL",{"_106":117,"_31":118,"_109":110},"info","Logging level (debug, info, error, etc.)","OBSIDIAN_API_KEY",{"_31":121,"_109":110},"API Key from the Obsidian Local REST API plugin","OBSIDIAN_BASE_URL",{"_106":124,"_31":125,"_109":110},"http://127.0.0.1:27123","Base URL of your Obsidian Local REST API","MCP_TRANSPORT_TYPE",{"_106":128,"_31":129,"_109":110},"http","Server transport: 'stdio' or 'http'","MCP_ALLOWED_ORIGINS",{"_31":132,"_109":110},"Comma-separated origins for CORS","MCP_AUTH_SECRET_KEY",{"_31":135,"_109":110},"32+ char secret for JWT auth (Not used in this version)","OBSIDIAN_VERIFY_SSL",{"_106":138,"_31":139,"_109":110},"true","Set to 'false' to disable SSL verification","OBSIDIAN_ENABLE_CACHE",{"_106":138,"_31":142,"_109":110},"Set to 'true' to enable the in-memory vault cache","OBSIDIAN_CACHE_REFRESH_INTERVAL_MIN",{"_106":145,"_31":146,"_109":110},"10","Refresh interval for the vault cache in minutes","required",[119],"object","githubProject",{"_35":36,"_152":153},"url","https://github.com/boweylou/obsidian-mcp-server-enhanced","githubRepository",{"_156":157,"_158":159,"_160":161,"_16":162,"_163":164,"_33":165,"_90":166,"_168":169,"_170":171,"_173":174},"defaultBranch","main","fullName","BoweyLou/obsidian-mcp-server-enhanced","githubTreeId",320492,17345,"language","TypeScript","obsidian-mcp-server-enhanced",{"_94":95,"_65":167},"stq8bx6za9","recentStargazers",1,"spdxLicense",{"_33":172},"Apache 2.0","stargazers",7,"glamaJson","inspectable",false,"npmPackage",{"_33":180,"_181":182},"obsidian-mcp-server","weeklyDownloads",209,"supportedPlatforms","scores",{"_186":187,"_188":-5,"_189":-5},"license",100,"quality","security","simpleIcon","toolCount",0,"rf3ivby9j4","updatedAt","2025-10-01T21:10:20.811105Z","meta",[198,201,203,210,213,215,218,221,224,227,230,232,235,238,240,242,244,246,248],{"_199":200},"title","Obsidian MCP Server - Enhanced | Glama",{"_202":32,"_33":31},"content",{"_204":205,"_206":207,"_208":209},"href","https://glama.ai/mcp/servers/@BoweyLou/obsidian-mcp-server-enhanced","rel","canonical","tagName","link",{"_202":34,"_211":212},"property","og:title",{"_202":32,"_211":214},"og:description",{"_202":216,"_211":217},"https://glama.ai/logo.png","og:logo",{"_202":219,"_211":220},"https://glama.ai/mcp/servers/@BoweyLou/obsidian-mcp-server-enhanced/og-image","og:image",{"_202":222,"_211":223},"630","og:image:height",{"_202":225,"_211":226},"1200","og:image:width",{"_202":228,"_211":229},"website","og:type",{"_202":205,"_211":231},"og:url",{"_202":233,"_211":234},"Glama – MCP Hosting Platform","og:site_name",{"_202":236,"_33":237},"summary_large_image","twitter:card",{"_202":233,"_33":239},"twitter:title",{"_202":32,"_33":241},"twitter:description",{"_202":219,"_33":243},"twitter:image",{"_202":222,"_33":245},"twitter:image:height",{"_202":225,"_33":247},"twitter:image:width",{"_249":250},"script:ld+json",{"_251":252,"_253":254},"@context","http://schema.org","@graph",[255],{"_251":256,"_257":258,"_259":260},"https://schema.org","@type","BreadcrumbList","itemListElement",[261,267,271,275],{"_257":262,"_263":264,"_33":265,"_266":169},"ListItem","item","/","Glama","position",{"_257":262,"_263":268,"_33":269,"_266":270},"/mcp","MCP",2,{"_257":262,"_263":272,"_33":273,"_266":274},"/mcp/servers","Servers",3,{"_257":262,"_263":276,"_33":34,"_266":277},"/mcp/servers/@BoweyLou/obsidian-mcp-server-enhanced",4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_281":282,"_29":288,"_323":324,"_196":336,"_333":360,"_361":362},"blob",{"_202":283,"_284":285,"_286":287},"#!/bin/bash\n# Monitor incoming HTTP requests to MCP server\n\necho \"Monitoring HTTP requests to MCP server...\"\necho \"Press Ctrl+C to stop\"\necho \"\"\n\n# Monitor both debug and info logs for HTTP activity\ntail -f logs/debug.log logs/info.log | grep -E \"(HTTP|session|Session|POST.*mcp|GET.*mcp|DELETE.*mcp|api_key|closed|Connection)\" --line-buffered | while read line; do\n echo \"[$(date '+%H:%M:%S')] $line\"\ndone","fileName","monitor-requests.sh","size",409,{"_41":42,"_13":289,"_51":32,"_52":32,"_16":53,"_54":290,"_33":34,"_88":299,"_96":-5,"_97":-5,"_98":302,"_184":322,"_190":-5,"_62":165,"_191":192,"_65":193,"_194":195},[44,45,46,47,48,49,50],[291,293,295,297],{"_57":292,"_31":64,"_65":66},{"_59":60,"_33":61,"_62":63},{"_57":294,"_31":72,"_65":73},{"_59":69,"_33":70,"_62":71},{"_57":296,"_31":79,"_65":80},{"_59":76,"_33":77,"_62":78},{"_57":298,"_31":86,"_65":87},{"_59":83,"_33":84,"_62":85},{"_90":300,"_62":95},{"_92":301},{"_94":95},{"_100":303,"_150":317,"_154":318,"_175":-5,"_176":177,"_178":321,"_183":-5},{"_102":304,"_147":316,"_109":149},{"_104":305,"_111":306,"_115":307,"_119":308,"_122":309,"_126":310,"_130":311,"_133":312,"_136":313,"_140":314,"_143":315},{"_106":107,"_31":108,"_109":110},{"_106":113,"_31":114,"_109":110},{"_106":117,"_31":118,"_109":110},{"_31":121,"_109":110},{"_106":124,"_31":125,"_109":110},{"_106":128,"_31":129,"_109":110},{"_31":132,"_109":110},{"_31":135,"_109":110},{"_106":138,"_31":139,"_109":110},{"_106":138,"_31":142,"_109":110},{"_106":145,"_31":146,"_109":110},[119],{"_35":36,"_152":153},{"_156":157,"_158":159,"_160":161,"_16":162,"_163":164,"_33":165,"_90":319,"_168":169,"_170":320,"_173":174},{"_94":95,"_65":167},{"_33":172},{"_33":180,"_181":182},{"_186":187,"_188":-5,"_189":-5},"member",{"_325":326,"_329":330,"_331":285,"_160":161,"_332":177,"_333":285,"_334":335,"_286":287,"_109":281},"commit",{"_327":328},"sha","9345846e4d708be0dc64022317a1832c7f5fdc43","contentStoredObjectPointerId",486645,"fullPath","indexable","path","safeToDisplayAsText",true,[337,339,341,343,345,346,347,349,350,351,352,353,354,355,356,357,358,359],{"_199":338},"monitor-requests.sh | Obsidian MCP Server - Enhanced | Glama",{"_202":340,"_33":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_204":342,"_206":207,"_208":209},"https://glama.ai/mcp/servers/@BoweyLou/obsidian-mcp-server-enhanced/blob/9345846e4d708be0dc64022317a1832c7f5fdc43/",{"_202":344,"_211":212},"monitor-requests.sh | Obsidian MCP Server - Enhanced",{"_202":340,"_211":214},{"_202":216,"_211":217},{"_202":348,"_211":220},"https://glama.ai/generated-images/og?title=monitor-requests.sh+%7C+Obsidian+MCP+Server+-+Enhanced",{"_202":222,"_211":223},{"_202":225,"_211":226},{"_202":228,"_211":229},{"_202":342,"_211":231},{"_202":233,"_211":234},{"_202":236,"_33":237},{"_202":233,"_33":239},{"_202":340,"_33":241},{"_202":348,"_33":243},{"_202":222,"_33":245},{"_202":225,"_33":247},"","treeMembers",[363,367,370,373,376,379,382,385,388,391,394,397,400,403,406,408,411,414,417,420,423,426,429,432],{"_325":364,"_331":365,"_333":365,"_109":366},{"_327":328},"docs","tree",{"_325":368,"_331":369,"_333":369,"_109":366},{"_327":328},".github",{"_325":371,"_331":372,"_333":372,"_109":366},{"_327":328},"scripts",{"_325":374,"_331":375,"_333":375,"_109":366},{"_327":328},"src",{"_325":377,"_331":378,"_333":378,"_109":281},{"_327":328},"CHANGELOG.md",{"_325":380,"_331":381,"_333":381,"_109":281},{"_327":328},"CLAUDE.md",{"_325":383,"_331":384,"_333":384,"_109":281},{"_327":328},".clinerules",{"_325":386,"_331":387,"_333":387,"_109":281},{"_327":328},"com.obsidian.mcp.plist",{"_325":389,"_331":390,"_333":390,"_109":281},{"_327":328},"Dockerfile",{"_325":392,"_331":393,"_333":393,"_109":281},{"_327":328},"env.json",{"_325":395,"_331":396,"_333":396,"_109":281},{"_327":328},".gitignore",{"_325":398,"_331":399,"_333":399,"_109":281},{"_327":328},"headers.txt",{"_325":401,"_331":402,"_333":402,"_109":281},{"_327":328},"LICENSE",{"_325":404,"_331":405,"_333":405,"_109":281},{"_327":328},"mcp.json",{"_325":407,"_331":285,"_333":285,"_109":281},{"_327":328},{"_325":409,"_331":410,"_333":410,"_109":281},{"_327":328},".ncurc.json",{"_325":412,"_331":413,"_333":413,"_109":281},{"_327":328},"package.json",{"_325":415,"_331":416,"_333":416,"_109":281},{"_327":328},"package-lock.json",{"_325":418,"_331":419,"_333":419,"_109":281},{"_327":328},"README.md",{"_325":421,"_331":422,"_333":422,"_109":281},{"_327":328},"repomix.config.json",{"_325":424,"_331":425,"_333":425,"_109":281},{"_327":328},"simple-test.js",{"_325":427,"_331":428,"_333":428,"_109":281},{"_327":328},"smithery.yaml",{"_325":430,"_331":431,"_333":431,"_109":281},{"_327":328},"tsconfig.json",{"_325":433,"_331":434,"_333":434,"_109":281},{"_327":328},"typedoc.json","actionData","errors"]

MCP directory API