MCP Tools for Obsidian

Add Obsidian integrations like semantic search and custom Templater prompts to Claude or any MCP client.

Catalog onlyCatalog onlySTDIO

Overview

MCP Tools for Obsidian is a plugin that integrates AI applications like Claude Desktop with your Obsidian vault, allowing for secure access and interaction through the Model Context Protocol (MCP).

To use this plugin, install it from Obsidian's Community Plugins, enable it, and follow the setup instructions to install the local MCP server. This will allow AI applications to interact with your notes securely.

Vault Access: AI assistants can read and reference your notes while maintaining security. - Semantic Search: Enables AI assistants to search your vault based on meaning and context. - Template Integration: Execute Obsidian templates through AI interactions with dynamic parameters.

Enhancing note-taking with AI-assisted semantic searches.
Automating template executions in Obsidian using AI.
Securely integrating AI applications with personal knowledge management systems.

Add to your AI client

Use these steps to connect MCP Tools for Obsidian in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "obsidian-mcp-tools-jacksteamdev": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-tools-jacksteamdev"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "obsidian-mcp-tools-jacksteamdev": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-tools-jacksteamdev"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "obsidian-mcp-tools-jacksteamdev": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-tools-jacksteamdev"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "obsidian-mcp-tools-jacksteamdev": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-tools-jacksteamdev"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools-jacksteamdev": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-tools-jacksteamdev"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "obsidian-mcp-tools-jacksteamdev": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-obsidian-mcp-tools-jacksteamdev"
      ]
    }
  }
}

FAQ

Can I use this plugin without Claude Desktop?

No, this plugin requires an MCP-compatible client like Claude Desktop to function.

Is my data secure when using this plugin?

Yes, the MCP server acts as a secure bridge, ensuring that AI applications do not have direct access to your vault files.

What are the prerequisites for using this plugin?

You need Obsidian v1.7.7 or higher, Claude Desktop, and the Local REST API plugin.

Developer tools