Integrations
Allows AI assistants to read, create, and manipulate notes in Obsidian vaults, with capabilities for reading active files, deleting files, inserting content at specific positions, appending content, opening files, listing vault files, and searching through notes.
MCP Obsidian
A server implementation of the Model Context Protocol (MCP) for integrating with Obsidian. This allows AI assistants to read, create, and manipulate notes in your Obsidian vault.
Features
- Read the active file in Obsidian
- Delete the active file
- Insert content at specific positions (headings, block references, frontmatter)
- Append content to files
- Open specific files
- List files in your vault
- Search through your notes
Prerequisites
Add to cursor
Place your secret in .env file
Choose command MCP and then enter this command
Installation
- Clone this repository:Copy
- Install dependencies:Copy
- Copy the example environment file and configure it:Copy
Configuration
Edit the .env
file with your specific configurations:
Usage
Start the MCP server:
The server will start and communicate with MCP-compatible AI assistants via standard I/O.
Available Tools
This implementation provides the following tools to AI assistants:
get_active_file
- Returns the content of the currently active filedelete_active_file
- Deletes the currently active fileinsert_active_file
- Modifies content relative to a heading, block reference, or frontmatter fieldappend_active_file
- Appends content to the end of the active fileopen_file
- Opens a specific file in Obsidiansearch_simple
- Searches for documents matching a text querylist_files
- Lists files in the root directory of your vaultlist_directory_files
- Lists files in a specific directory of your vault
Development
Project Structure
Adding New Tools
To add a new tool:
- Create a new file in the
src/tools/
directory - Implement the tool using the MCP SDK
- Import and register the tool in
src/index.ts
License
This project is licensed under the MIT License - see the LICENSE.md file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
This server cannot be installed
A server implementation that allows AI assistants to read, create, and manipulate notes in Obsidian vaults through the Model Context Protocol.
Related MCP Servers
- -securityAlicense-qualityEnables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.Last updated -598149TypeScriptMIT License
- -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 -37TypeScriptMIT License
- -securityFlicense-qualityThis project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.Last updated -5987JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with the HackMD API for managing notes, including creating, reading, updating, and deleting notes.Last updated -124020TypeScriptMIT License