ObsiMCP

ObsiMCP

A lightweight, extendable MCP server for automating operations on Obsidian vaults, powered by mcp-go. ObsiMCP helps you efficiently manage your Obsidian notes and build your own personal knowledge base.

✨ Features

• 📖 Read a Markdown note
• 🔍 Search all notes with the same file name across the entire vault.
• ✍️ Write content to an existing note, supporting both:
  • append mode (adds to the end)
  • overwrite mode (replaces the file content)
• 🆕 Create a new note
• 🗑️ Delete a note
• 📁 List files and subfolders within a given folder (non-recursive).
• 🏷 Modify, add, and get the frontmatter in Note
• ...

📦 Requirements

• Go 1.20+ (The lower version may work, but I haven't tried it yet.)
• An initialized Obsidian vault directory

🚀 Getting Started

git clone https://github.com/IAMLEIzZ/ObsiMCP.git
cd ObsiMCP
go build -o main main.go

Configure your vault path via the config/config.yaml file or environment variable as needed.

vault:
  path: "your osbidian vault path"

⚠️ The BackUpDir Config

To protect your files, you must set up a backup folder. When you use mcp-server to overwrite or delete, a backup file will be automatically generated to prevent your AI assistant from unstable operation. (You can manually delete outdated backup files regularly, and we will consider adding an automatic deletion function later.)

backup:
  path: "your backup dir"

🧠 Use Cases

• 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.

For example, in deepchat you can start it like this (Please open the file read and write permissions at the same time)

{
  "mcpServers": {
    "ObsiMCP": {
      "command": "Your The absolute path to your main executable", 
      "args": [],
      "shell": false,
      "env": {}
    }
  }
}

🛠 Example Tool Definitions

Each tool in the MCP server corresponds to an operation:

Tool Name	Description
ReadNote	Reads content from a given Markdown file.
GetNote	Finds all notes in the vault with a matching name.
WriteNote	Appends or overwrites content in an existing note.
CreateANote	Creates a new note without initial content.
DeleteNote	Deletes a note by its name and backup it.
GetNoteList	Lists files and subfolders in a given folder.
MoveOneNote	Move a note to another folder.
GetNoteList	Lists files and subfolders in a given folder.
FindAllFolderByName	Find all folders with the same name in the vault according to the folder name.
CreateFolder	Delete a folder with folder name.
GetNoteFrontmatter	Get a note frontmatter information
AddFrontmatter	Add frontmatter information to a note
GetNotetags	Add tags to a note
...	...

🔗 References

• mcp-go

📄 License

MIT License. Feel free to use, modify, and contribute!