MCPgee
MCPgee
MCPgeeMCPgee

Obsidian MCP Server

v3.2.1•Knowledge & Memory•stable

Enables AI assistants like Claude to read, search, create, and manage notes in Obsidian vaults, with features for link analysis, tag management, daily notes, templates, and optional Google Calendar integration. Provides comprehensive vault operations

ai-toolsknowledge-basellmllm-agentmcp
Share:
545
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Obsidian MCP Server?

Obsidian MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants like claude to read, search, create, and manage notes in obsidian vaults, with features for link analysis, tag management, daily notes, templates, and optional google calendar in...

Enables AI assistants like Claude to read, search, create, and manage notes in Obsidian vaults, with features for link analysis, tag management, daily notes, templates, and optional Google Calendar integration. Provides comprehensive vault operations

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

Features

  • Enables AI assistants like Claude to read, search, create, a

Use Cases

AI-powered Obsidian vault management
Note creation and linking
Google Calendar integration
cyanheads

Maintainer

LicenseApache 2.0
Languagetypescript
Versionv3.2.1
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

NPM

npx -y obsidian-mcp-server

Manual Installation

npx -y obsidian-mcp-server

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 MCP Server

The Obsidian MCP Server connects AI assistants like Claude to your Obsidian vault via the Local REST API plugin, providing 14 tools for reading, searching, creating, editing, and deleting notes. It supports frontmatter management, tag operations, command palette execution, daily notes, link analysis, and optional Google Calendar integration. Researchers, writers, and knowledge workers use it to let AI assistants directly query and update their personal knowledge base, automate note organization, and bridge calendar events with vault content.

Prerequisites

  • Obsidian installed with the Local REST API community plugin enabled
  • An API key from the Local REST API plugin settings in Obsidian
  • Node.js 18+ or Bun runtime installed
  • An MCP-capable client such as Claude Desktop or Claude Code
1

Install and configure the Obsidian Local REST API plugin

In Obsidian, open Settings → Community Plugins, search for 'Local REST API', and install and enable it. After enabling, go to the plugin settings to copy your API key. The plugin listens on port 27123 by default.

2

Install the MCP server

Install obsidian-mcp-server using npx (no local install needed) or Bun for best performance.

# Using npx
npx -y obsidian-mcp-server

# Using Bun (recommended)
bunx obsidian-mcp-server@latest
3

Configure environment variables

Set the required OBSIDIAN_API_KEY environment variable and optionally adjust the base URL and timeout. The base URL defaults to http://127.0.0.1:27123 which matches the Local REST API plugin default.

export OBSIDIAN_API_KEY=your-api-key-from-obsidian-plugin
export OBSIDIAN_BASE_URL=http://127.0.0.1:27123
export OBSIDIAN_VERIFY_SSL=false
4

Add to Claude Desktop configuration

Add the server to your claude_desktop_config.json with the API key and base URL. Restart Claude Desktop after saving.

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp-server"],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-from-obsidian-plugin",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "OBSIDIAN_VERIFY_SSL": "false"
      }
    }
  }
}
5

Restrict vault access (optional)

Use OBSIDIAN_READ_PATHS and OBSIDIAN_WRITE_PATHS to limit which vault folders the AI can access. Set OBSIDIAN_READ_ONLY=true to prevent all write operations.

export OBSIDIAN_READ_PATHS=Projects,Journal
export OBSIDIAN_WRITE_PATHS=Projects
export OBSIDIAN_READ_ONLY=false

Obsidian MCP Server Examples

Client configuration

Claude Desktop JSON configuration for the Obsidian MCP server using the npm package.

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp-server"],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-from-obsidian-plugin",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123",
        "OBSIDIAN_VERIFY_SSL": "false",
        "OBSIDIAN_READ_ONLY": "false"
      }
    }
  }
}

Prompts to try

Example prompts once the Obsidian MCP server is connected to Claude.

- "Search my Obsidian vault for notes about machine learning"
- "Create a new note in my Projects folder titled 'Q3 Planning' with a summary of our goals"
- "List all notes tagged with #todo and summarize what I need to do this week"
- "Append today's meeting notes to my Daily Notes for June 13th"
- "Find all notes that link to my 'Project Alpha' note and show me the context"

Troubleshooting Obsidian MCP Server

Connection refused when the MCP server tries to reach Obsidian

Ensure Obsidian is running and the Local REST API plugin is enabled. The plugin must be active for the server to reach port 27123. Check the plugin settings to confirm it shows as running.

401 Unauthorized errors when accessing vault notes

Verify that OBSIDIAN_API_KEY matches the key shown in Obsidian's Local REST API plugin settings. The key changes when you regenerate it in the plugin, so update your MCP server config accordingly.

SSL certificate errors when OBSIDIAN_VERIFY_SSL is true

The Local REST API plugin uses a self-signed certificate by default. Set OBSIDIAN_VERIFY_SSL=false in your environment configuration to disable certificate verification for local connections.

Frequently Asked Questions about Obsidian MCP Server

What is Obsidian MCP Server?

Obsidian MCP Server is a Model Context Protocol (MCP) server that enables ai assistants like claude to read, search, create, and manage notes in obsidian vaults, with features for link analysis, tag management, daily notes, templates, and optional google calendar integration. provides comprehensive vault operations It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Obsidian MCP Server?

Install via npm with the command: npx -y obsidian-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Obsidian MCP Server?

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

Is Obsidian MCP Server free to use?

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

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Obsidian MCP Server Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to Obsidian MCP Server? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

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.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

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

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

Read the full setup guide →

Ready to use Obsidian MCP Server?

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
Explore All ServersRead Our Guides