Obsidian MCP Server

by marcelmarais

Integrations

  • Referenced for potential use in commands like creating notes that describe code changes made in Git.

  • Enables reading from and writing to an Obsidian vault, including retrieving file lists, reading file contents, checking open todos, and updating or creating markdown files.

Obsidian MCP Server

A lightweight Model Context Protocol (MCP) server that enables AI assistants like Cursor & Claude to read from and write to your Obsidian vault.

Example Interactions

  • "Create a new note for standup tomorrow describing the code changes I've made today" (should also use Git)
  • "Check my notes about project ideas"
  • "Check what todos I have related to refactoring"

Tools

Read

  1. getAllFilenames
    • Gets a list of all filenames in the Obsidian vault
    • Useful for discovering what files are available
  2. readMultipleFiles
    • Retrieves the contents of specified files from the Obsidian vault
    • Supports exact filenames, partial filenames, or case-insensitive matches
    • Each file's content is prefixed with '# File: filename' for clear identification
  3. getOpenTodos
    • Retrieves all open TODO items from markdown files in the Obsidian vault
    • Finds unchecked checkbox items (lines containing '- [ ] ')
    • Returns them with their file locations

Write

  1. updateFileContent
    • Updates the content of a specified file in the Obsidian vault with new markdown content
    • If the file doesn't exist, it will be created
    • Automatically creates any necessary directories

Install & build

npm install obsidian-mcp-server npm run build

Integrating with Claude Desktop and Cursor

To use your MCP server with Claude Desktop add it to your Claude configuration:

{ "mcpServers": { "obsidian": { "command": "node", "args": [ "obsidian-mcp-server/build/index.js", "/path/to/your/vault" ] } } }

For Cursor go to the MCP tab Cursor Settings (command + shift + J). Add a server with this command:

node obsidian-mcp-server/build/index.js /path/to/your/vault

Comparison with Other Solutions

While this implementation is intentionally lightweight, other solutions like jacksteamdev/obsidian-mcp-tools offer a more feature-rich approach as an Obsidian plugin.

This standalone server has the advantage of direct filesystem access without requiring the Obsidian application to be running.

Resources

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A lightweight server that enables AI assistants like Cursor & Claude to read from and write to Obsidian vaults, allowing actions like creating notes, checking existing content, and managing todos through natural language.

  1. Example Interactions
    1. Tools
      1. Read
      2. Write
    2. Install & build
      1. Integrating with Claude Desktop and Cursor
        1. Comparison with Other Solutions
          1. Resources

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              Enables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.
              Last updated -
              598
              149
              TypeScript
              MIT License
              • Apple
            • -
              security
              A
              license
              -
              quality
              A local MCP server that enables AI applications like Claude Desktop to securely access and work with Obsidian vaults, providing capabilities for reading notes, executing templates, and performing semantic searches.
              Last updated -
              60
              TypeScript
              MIT License
              • Apple
              • Linux
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that enables AI assistants to read, write, and manipulate notes in your Obsidian vault through a standardized interface.
              Last updated -
              598
              TypeScript
              ISC License
            • -
              security
              A
              license
              -
              quality
              A server that enables AI assistants like Claude to safely run Python code and access websites, processing data for better AI understanding while providing helpful error messages.
              Last updated -
              2
              Python
              GPL 3.0
              • Linux
              • Apple

            View all related MCP servers

            ID: 0vtaasg5k9