drio
Open app

MCP server for Obsidian

Source

MCP server that interacts with Obsidian via the Obsidian rest API community plugin

Catalog onlyCatalog onlySTDIO

Overview

MCP server for Obsidian is a tool designed to interact with Obsidian through the Local REST API community plugin, allowing users to manage and manipulate their notes programmatically.

To use the MCP server, ensure that you have the Obsidian REST API community plugin installed. You can then connect to the server using the provided API key and make requests based on your needs.

  • List files and directories in your Obsidian vault. - Retrieve content from specific files. - Search through notes using specified queries. - Append or patch content in existing notes.
  1. Automating the retrieval and summarization of notes.
  2. Managing large sets of notes by searching for specific keywords.
  3. Creating new structured documents based on summarized content from existing notes.

Add to your AI client

Use these steps to connect MCP server 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": {
    "mcp-obsidian-markuspfundstein": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-obsidian-markuspfundstein"
      ]
    }
  }
}

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": {
    "mcp-obsidian-markuspfundstein": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-obsidian-markuspfundstein"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

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

VS Code (Copilot)

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

.vscode/mcp.json

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Cline

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

Cline MCP Settings (via UI)

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

FAQ

How do I configure the server with my Obsidian API Key?

You can configure the server by adding the API key directly into the server config or by creating a .env file in the working directory.

What is required to run the MCP server?

You need to have the Obsidian REST API community plugin installed and enabled in your Obsidian settings.

Can I access my notes from different machines?

Yes, as long as the MCP server is set up with the correct API key on each machine, you can manage your notes from anywhere.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":110,"uuid":"2f91a880-e901-40bc-9a2e-f80e85ecfe60","name":"mcp-obsidian","title":"MCP server for Obsidian","description":"MCP server that interacts with Obsidian via the Obsidian rest API community plugin","avatar_url":"https://avatars.githubusercontent.com/u/1137867?v=4","created_at":"2024-12-13T09:01:06.323Z","updated_at":"2024-12-13T09:49:52.928Z","status":"created","author_name":"MarkusPfundstein","author_avatar_url":"https://avatars.githubusercontent.com/u/1137867?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MarkusPfundstein/mcp-obsidian","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/761cfa9388cfd3c84b2617f30ad68908a40473925fa7b87524fd29b2abd6eaad/68747470733a2f2f676c616d612e61692f6d63702f736572766572732f33776b6f31626875656b2f6261646765","type":null,"metadata":"{\"star\":\"1025\",\"license\":\"MIT license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-04-14 13:24:19\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools