-
securityA
license-
qualityEnables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.
Last updated -
228
545
MIT License
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
getAllFilenames
Gets a list of all filenames in the Obsidian vault
Useful for discovering what files are available
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
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
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
This server cannot be installed
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.
Related MCP Servers
- -securityAlicense-qualityProvides a standardized interface for AI assistants to interact with Obsidian vaults through a local REST API, enabling reading, writing, searching, and managing notes.Last updated -58MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to read, write, and manipulate notes in your Obsidian vault through a standardized interface.Last updated -52282ISC License
- -securityAlicense-qualityA server implementation that allows AI assistants to read, create, and manipulate notes in Obsidian vaults through the Model Context Protocol.Last updated -6815MIT License