obsidian-mcp-server-enhanced

BoweyLou/obsidian-mcp-server-enhanced

3.3

If you are the rightful owner of obsidian-mcp-server-enhanced and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Obsidian MCP Server - Enhanced is a powerful tool that integrates with Claude.ai and Tailscale to provide secure and advanced access to your Obsidian vault, enabling AI agents to manage and interact with your notes efficiently.

The Enhanced Obsidian MCP Server is a sophisticated platform designed to facilitate seamless interaction between AI agents and your Obsidian vault. This server acts as a bridge, allowing applications that understand the Model Context Protocol (MCP) to interact directly and safely with your vault. It is built on the robust `mcp-ts-template` and offers a modular architecture with comprehensive error handling, logging, and security features. The server supports Claude.ai Remote MCP integration, providing a native HTTP transport layer and simple API key authentication for enterprise-grade stability. Additionally, it integrates with Tailscale to offer secure remote access, ensuring all traffic is encrypted and access is controlled. The server also enhances task querying capabilities, allowing for advanced interactions with the Obsidian Tasks plugin. With these features, the Enhanced Obsidian MCP Server is ideal for automating vault management, integrating Obsidian into AI workflows, and building custom tools.

Features

  • Claude.ai Remote Integration: Provides seamless integration with Claude.ai's Remote MCP feature, offering native HTTP transport and simple API key authentication.
  • Tailscale Secure Remote Access: Enables secure access to your Obsidian vault from anywhere with Tailscale Funnel integration and end-to-end encryption.
  • Enhanced Task & Query System: Offers advanced querying capabilities with deep integration with the Obsidian Tasks plugin, including natural language date recognition and priority detection.
  • Comprehensive Obsidian Integration: Supports a wide range of vault operations, including reading, updating, searching, listing, and managing frontmatter and tags.
  • Vault Cache Service: Includes an intelligent in-memory cache to enhance performance and resilience, providing a fallback for search operations.

Usages

usage with Claude ai

{
  "url": "https://your-machine-name.tail123abc.ts.net/mcp?api_key=your-obsidian-api-key",
  "name": "Obsidian Vault"
}

usage with local MCP client

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/obsidian-mcp-server-enhanced/dist/index.js"],
      "env": {
        "OBSIDIAN_API_KEY": "YOUR_OBSIDIAN_API_KEY",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "OBSIDIAN_VERIFY_SSL": "false",
        "OBSIDIAN_ENABLE_CACHE": "true"
      }
    }
  }
}

Tools

  1. obsidian_read_file

    Retrieves the content and metadata of a specified file.

  2. obsidian_update_file

    Modifies notes using whole-file operations.

  3. obsidian_search_replace

    Performs search-and-replace operations within a target note.

  4. obsidian_global_search

    Performs a search across the entire vault.

  5. obsidian_list_files

    Lists files and subdirectories within a specified vault folder.

  6. obsidian_manage_frontmatter

    Atomically manages a note's YAML frontmatter.

  7. obsidian_manage_tags

    Adds, removes, or lists tags for a note.

  8. obsidian_delete_file

    Permanently deletes a specified file from the vault.

  9. obsidian_dataview_query

    Execute Dataview DQL queries against your vault.

  10. obsidian_task_query

    Search and analyze tasks across your vault.