Obsidian MCP Server logo

Obsidian MCP Server

by marcelmarais

A lightweight Model Context Protocol (MCP) server that enables AI assistants like Cursor & Claude to read from and write to your Obsidian vault. It allows AI tools to interact with your notes for tasks like note creation, information retrieval, and task management.

View on GitHub

Last updated: N/A

What is Obsidian MCP Server?

The Obsidian MCP Server is a standalone server that implements the Model Context Protocol, allowing AI assistants to read and write to your Obsidian vault. It provides a direct filesystem access method, enabling AI tools to interact with your notes even when the Obsidian application is not running.

How to use Obsidian MCP Server?

  1. Install the server using npm install obsidian-mcp-server. 2. Build the server using npm run build. 3. Configure your AI assistant (Claude or Cursor) to connect to the server by providing the command to execute the server and the path to your Obsidian vault. Example configurations are provided in the README.

Key features of Obsidian MCP Server

  • Read and write access to Obsidian vault

  • Integration with Claude and Cursor

  • Direct filesystem access

  • Lightweight implementation

  • Supports creating new notes, updating existing notes, and retrieving information

Use cases of Obsidian MCP Server

  • Creating new notes based on AI prompts

  • Retrieving information from your notes using AI

  • Managing tasks and todos in your notes with AI

  • Summarizing notes using AI

  • Generating content for your notes using AI

FAQ from Obsidian MCP Server

What is the Model Context Protocol (MCP)?

MCP is a protocol that allows AI assistants to interact with external data sources, such as your Obsidian vault.

What AI assistants are supported?

Currently, the server is designed to integrate with Claude and Cursor.

Does Obsidian need to be running for the server to work?

No, the server provides direct filesystem access, so Obsidian does not need to be running.

How do I configure the server to access my Obsidian vault?

You need to provide the path to your Obsidian vault in the configuration for your AI assistant.

What are the limitations of this server compared to the Obsidian plugin?

This server is intentionally lightweight. The Obsidian plugin offers a more feature-rich approach, but requires the Obsidian application to be running.