Overview
What is ObsiMCP?
ObsiMCP is a lightweight, extendable MCP server for automating operations on Obsidian vaults, powered by mcp-go. It helps you efficiently manage your Obsidian notes and build your own personal knowledge base.
How to use ObsiMCP?
Clone the repository, build the executable with go build -o main main.go, then configure your vault path in config/config.yaml or via an environment variable. You must also set up a backup directory to protect files. Integration is shown with deepchat using an MCP client configuration.
Key features of ObsiMCP
- Read a Markdown note from the vault
- Search all notes with the same file name
- Write content in append or overwrite mode
- Create a new note without initial content
- Delete a note and automatically back it up
- Modify, add, and get note frontmatter
Use cases of ObsiMCP
- Build agents or copilots that understand and modify your notes
- Integrate with Obsidian from external apps or LLMs
- Automate note maintenance, renaming, or content updates
FAQ from ObsiMCP
What are the system requirements?
Go 1.20+ and an initialized Obsidian vault directory are required.
How do I configure the vault path?
Set the vault path in the config/config.yaml file or via an environment variable in the vault.path field.
How does the backup feature work?
When you overwrite or delete a note, a backup file is automatically generated in the configured backup directory to prevent data loss.
What operations are available?
ObsiMCP provides tools such as ReadNote, WriteNote, CreateANote, DeleteNote, GetNoteList, MoveOneNote, and functions for frontmatter and tags.
Is there an example integration with other apps?
Yes, an example configuration for deepchat shows how to start ObsiMCP with the correct executable path and read/write permissions.
