Obsidian Notes

🚀 Obsidian MCP Server

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

🚀 Quick Start

✨ Features

• Example Interactions:
  • "Create a new note describing the code changes I made today and schedule a stand-up meeting for tomorrow" (should also use Git).
  • "Check my notes related to project ideas".
  • "View my to-dos related to refactoring".
• Tools:
  • Reading:
    1. getAllFilenames
    • Get a list of filenames of all files in the Obsidian note vault.
    • Useful for discovering available files.
    2. readMultipleFiles
    • Retrieve the content of specified files from the Obsidian note vault.
    • Supports exact filenames, partial filenames, or case-insensitive matching.
    • Each file's content is preceded by '# File: filename' for clear identification.
    3. getOpenTodos
    • Retrieve all open TODO items in the Obsidian note vault.
    • Find unchecked checkbox items (lines containing '- [ ] ').
    • Return with their file locations.
  • Writing:
    1. updateFileContent
    • Update the content of a specified file in the Obsidian note vault with new Markdown content.
    • Automatically creates the file if it doesn't exist.
    • Automatically creates any necessary directories.

📦 Installation

npm install obsidian-mcp-server
npm run build

💻 Usage Examples

Basic Usage

To integrate 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 in Cursor Settings (press Command + Shift + J). Add a server using the following command:

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

📚 Documentation

Comparison with Other Solutions

Although this implementation is deliberately kept lightweight, other solutions like jacksteamdev/obsidian-mcp-tools offer more feature-rich Obsidian plugins.

The advantage of this standalone server is that it provides direct access to the file system without running the Obsidian application.

📄 Resources

• Model Context Protocol Documentation
• MCP Server Repository