Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • Jira MCP Server
  • Kubectl MCP Tool
  • mem0 MCP Server
  • Kintone MCP Server
  • MongoDB MCP Server for LLMs
Back to MCP Servers
obsidian-mcp

obsidian-mcp

Public
StevenStavrakis/obsidian-mcp

Enables AI assistants to interact with Obsidian vaults via Model Context Protocol, offering note reading, creation, editing, deletion, tag management, and vault searching capabilities.

typescript
0 tools
May 29, 2025
Updated Jun 4, 2025

Supercharge Your AI with obsidian-mcp

MCP Server

Unlock the full potential of obsidian-mcp through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

Obsidian MCP Server

An MCP (Model Context Protocol) server that enables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.

Warning!!!

This MCP has read and write access (if you allow it). Please. PLEASE backup your Obsidian vault prior to using obsidian-mcp to manage your notes. I recommend using git, but any backup method will work. These tools have been tested, but not thoroughly, and this MCP is in active development.

Features

  • Read and search notes in your vault
  • Create new notes and directories
  • Edit existing notes
  • Move and delete notes
  • Manage tags (add, remove, rename)
  • Search vault contents

Requirements

  • Node.js 20 or higher (might work on lower, but I haven't tested it)
  • An Obsidian vault

Install

Installing Manually

Add to your Claude Desktop configuration:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "obsidian": { "command": "npx", "args": ["-y", "obsidian-mcp", "/path/to/your/vault", "/path/to/your/vault2"] } } }

Replace /path/to/your/vault with the absolute path to your Obsidian vault. For example:

MacOS/Linux:

"/Users/username/Documents/MyVault"

Windows:

"C:\\Users\\username\\Documents\\MyVault"

Restart Claude for Desktop after saving the configuration. You should see the hammer icon appear, indicating the server is connected.

If you have connection issues, check the logs at:

  • MacOS: ~/Library/Logs/Claude/mcp*.log
  • Windows: %APPDATA%\Claude\logs\mcp*.log

Installing via Smithery

Warning: I am not affiliated with Smithery. I have not tested using it and encourage users to install manually if they can.

To install Obsidian for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install obsidian-mcp --client claude

Development

# Clone the repository git clone https://github.com/StevenStavrakis/obsidian-mcp cd obsidian-mcp # Install dependencies npm install # Build npm run build

Then add to your Claude Desktop configuration:

{ "mcpServers": { "obsidian": { "command": "node", "args": ["/build/main.js", "/path/to/your/vault", "/path/to/your/vault2"] } } }

Available Tools

  • read-note - Read the contents of a note
  • create-note - Create a new note
  • edit-note - Edit an existing note
  • delete-note - Delete a note
  • move-note - Move a note to a different location
  • create-directory - Create a new directory
  • search-vault - Search notes in the vault
  • add-tags - Add tags to a note
  • remove-tags - Remove tags from a note
  • rename-tag - Rename a tag across all notes
  • manage-tags - List and organize tags
  • list-available-vaults - List all available vaults (helps with multi-vault setups)

Documentation

Additional documentation can be found in the docs directory:

  • creating-tools.md - Guide for creating new tools
  • tool-examples.md - Examples of using the available tools

Security

This server requires access to your Obsidian vault directory. When configuring the server, make sure to:

  • Only provide access to your intended vault directory
  • Review tool actions before approving them

Troubleshooting

Common issues:

  1. Server not showing up in Claude Desktop

    • Verify your configuration file syntax
    • Make sure the vault path is absolute and exists
    • Restart Claude Desktop
  2. Permission errors

    • Ensure the vault path is readable/writable
    • Check file permissions in your vault
  3. Tool execution failures

    • Check Claude Desktop logs at:
      • macOS: ~/Library/Logs/Claude/mcp*.log
      • Windows: %APPDATA%\Claude\logs\mcp*.log

License

MIT

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • Jira MCP Server
    Jira MCP Server

    Enables AI assistants to seamlessly interact with Jira via Model Context Protocol, offering project ...

    Added May 30, 2025
  • Kubectl MCP Tool
    Kubectl MCP Tool

    Enables AI assistants to interact with Kubernetes clusters via natural language using the Model Cont...

    Added May 30, 2025
  • mem0 MCP Server
    mem0 MCP Server

    TypeScript implementation of a Model Context Protocol server offering memory stream creation, conten...

    Added May 30, 2025
  • Kintone MCP Server
    Kintone MCP Server

    Enables seamless integration with kintone via Model Context Protocol, offering comprehensive capabil...

    25 tools
    Added May 30, 2025
  • MongoDB MCP Server for LLMs
    MongoDB MCP Server for LLMs

    Enables LLMs to seamlessly interact with MongoDB databases via Model Context Protocol, offering sche...

    Added May 30, 2025