Obsidian MCP Server
Description
# Obsidian MCP Server A lightweight [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 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…
About
# Obsidian MCP Server A lightweight [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 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"…
Details
- Author
- marcelmarais
- GitHub stars
- 29
- Downloads
- 289
- Categories
- Productivity, Other, Knowledge Base
Jump to
- getAllFilenames – lists all filenames in the vault
- readMultipleFiles – retrieves file contents with exact or partial name matches
- getOpenTodos – finds all unchecked todo items (- [ ]) across markdown files
- updateFileContent – creates or overwrites files, auto‑creating directories
- Standalone server – no Obsidian application needed for filesystem access
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Obsidian MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install with npm install obsidian-mcp-server, then build with npm run build. Add the server to Claude Desktop’s claude_desktop_config.json using node obsidian-mcp-server/build/index.js /path/to/your/vault. In Cursor, go to the MCP tab and add a server with the same command.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"obsidian mcp server": {
"obsidian-mcp-server-marcelmarais": {
"command": "node",
"args": [
"obsidian-mcp-server/build/index.js",
"/path/to/your/vault"
]
}
}
}
}McpServers
{
"obsidian-mcp-server-marcelmarais": {
"command": "node",
"args": [
"obsidian-mcp-server/build/index.js",
"/path/to/your/vault"
]
}
}- "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"
- Gets a list of all filenames in the Obsidian vault
- Useful for discovering what files are available
- 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
- Retrieves all open TODO items from markdown files in the Obsidian vault
- Finds unchecked checkbox items (lines containing '- [ ] ')
- Returns them with their file locations
- 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
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 tabCursor Settings(command + shift + J). Add a server with this command:
node obsidian-mcp-server/build/index.js /path/to/your/vault
While this implementation is intentionally lightweight, other solutions likejacksteamdev/obsidian-mcp-toolsoffer 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.
- Model Context Protocol Documentation
- MCP Servers Repository
MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.
Integrates Model Context Protocol (MCP) with Obsidian, allowing AI assistants to interact with your notes and vault.
A Model Context Protocol (MCP) Server for https://joplinapp.org/ that enables note access through the https://modelcontextprotocol.io. Perfect for integration with AI assistants like Claude.
A service for reading, writing, and managing markdown documentation with frontmatter metadata.
Connect your AI assistant to your personal knowledge base. Search, save links, create notes and to-dos. AI processes everything automatically.
An MCP server for interacting with Obsidian notes. Requires the OBSIDIAN_VAULT_PATH environment variable to be set.
Interact with your Obsidian vault using natural language.
Interact with your Obsidian vault using the Local REST API plugin, enabling LLMs to access and manage your notes.
Interact with your Obsidian notes and vaults using the Local REST API plugin.
A server for interacting with your Obsidian vault.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
