mcp-obsidian-setup

Configure the mcp-obsidian MCP server to connect Claude Code to Obsidian.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/ckt520728/claude-skills --skill mcp-obsidian-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-obsidian-setup
Source: https://github.com/ckt520728/claude-skills/tree/main/mcp-obsidian-setup
Command: npx skills add https://github.com/ckt520728/claude-skills --skill mcp-obsidian-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, uvx, notebooklm-mcp-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a step-by-step guide for installing, configuring, and troubleshooting the mcp-obsidian MCP server, which connects Claude Code to Obsidian and resolves common issues like authentication problems and file lock errors.

Core Features & Use Cases

  • Installation & Configuration: Detailed instructions for setting up the mcp-obsidian MCP server, including installing necessary plugins and configuring vault paths.
  • Troubleshooting: Guidance for resolving common issues like authentication errors, file lock errors, and version mismatches.
  • Use Case: For users who need to ensure their Claude Code is connected to the correct Obsidian vault and want to automate workflows involving the MCP server.

Quick Start

Use the mcp-obsidian-setup skill to install and configure the mcp-obsidian MCP server for Claude Code by following the instructions in the SKILL.md file.

Frequently Asked Questions about mcp-obsidian-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Claude Code to my Obsidian vault?

You can connect Claude Code to Obsidian by configuring the mcp-obsidian MCP server with a Local REST API. This requires installing specific Python CLI tools and setting the correct vault paths to establish the connection.

Why does my mcp-obsidian MCP server keep getting authentication expired errors?

Authentication expired errors in the mcp-obsidian MCP server typically occur due to misconfigured Local REST API settings. Troubleshooting involves verifying your authentication tokens and ensuring the Obsidian REST API plugin is correctly configured.

Do I need Python to set up the MCP server for Obsidian?

Yes, setting up the mcp-obsidian MCP server requires Python and specific CLI tools like uvx and notebooklm-mcp-cli. These dependencies are necessary to manage the connection between Claude Code and your Obsidian vault.

What is the best way to fix file lock errors with the Obsidian MCP server?

To resolve file lock errors with the Obsidian MCP server, you should ensure no other processes are accessing the vault simultaneously. The setup guide provides troubleshooting steps to clear locks and resolve version mismatches.

Can I automate Obsidian workflows using Claude Code?

Yes, once the mcp-obsidian MCP server is configured, you can automate Obsidian workflows through Claude Code. The connection allows Claude to interact with your vault data, enabling automated note management and processing.