Provides tools for managing notes in an Obsidian vault, including creating, reading, updating, deleting notes, searching, listing, and retrieving metadata with tag extraction.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@obsidian-mcp-server search for notes about machine learning"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🔗 Model Context Protocol server for Obsidian - Connect your knowledge base to AI
📝 Note Management: Create, read, update, and delete notes
🔍 Search: Full-text search across your vault
📋 Listing: List notes with filtering options
📊 Metadata: Get file size, timestamps, tags, and properties
⏰ Sorting: Sort notes by creation/modification time or size
🏷️ Tag Extraction: Automatically extract tags from frontmatter and content
🔒 Safe: Path validation to prevent directory traversal
⚡ Fast: Efficient file operations
Related MCP server: Obsidian MCP Server
npm install -g @indiegeeker/obsidian-mcp-server
# or
pnpm install -g @indiegeeker/obsidian-mcp-serverAdd to your Claude Desktop config:
{
"mcpServers": {
"obsidian": {
"command": "obsidian-mcp-server",
"env": {
"OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
}
}
}
}Create a new note in your vault.
Parameters:
filename (required): Name of the note
content (required): Markdown content
path (optional): Folder path within vault
Read an existing note's content and frontmatter.
Parameters:
filepath (required): Path to the note
Search notes by content.
Parameters:
query (required): Search string
path (optional): Limit search to folder
List all notes in vault or folder.
Parameters:
path (optional): Folder to list
recursive (optional): Include subfolders
Update an existing note's content.
Parameters:
filepath (required): Path to the note
content (required): New content
append (optional): Append instead of replacing
Delete a note from the vault.
Parameters:
filepath (required): Path to the note to delete
Get detailed metadata for a note.
Parameters:
filepath (required): Path to the note
includeTags (optional): Extract tags from frontmatter and content (default: true)
Returns:
File size (bytes and formatted)
Creation time
Modification time
Frontmatter properties
Extracted tags (from frontmatter and #hashtags)
List notes sorted by various criteria.
Parameters:
path (optional): Folder to list (default: root)
recursive (optional): Include subfolders (default: true)
sortBy (optional): Sort criterion - "created", "modified", "size", or "name" (default: "modified")
order (optional): Sort order - "asc" or "desc" (default: "desc")
includeMetadata (optional): Include size and timestamps (default: true)
limit (optional): Maximum number of notes to return
# Clone the repo
git clone https://github.com/indiegeeker/obsidian-mcp-server.git
# Install dependencies
pnpm install
# Build
pnpm run build
# Watch mode
pnpm run devMIT
Create a new note in the Obsidian vault
Inputs: content (required), filename (required), path.
Delete a note from the vault
Inputs: filepath (required).
Get detailed metadata for a specific note including size, timestamps, frontmatter tags and properties
Inputs: filepath (required), includeTags.
List all notes in the vault or a specific folder
Inputs: path, recursive.
List notes sorted by creation time, modification time, or size
Inputs: path, limit, order, sortBy, +2 more.
Read the content of an existing note
Inputs: filepath (required).
Search notes by content or filename
Inputs: query (required), path.
Update an existing note's content
Inputs: content (required), filepath (required), append.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 8 tools
Most tools have distinct purposes, but list_notes and list_notes_sorted overlap significantly; the sorted version could be a parameter of list_notes. Additionally, get_note_metadata vs read_note might be confused for retrieving note details, though descriptions clarify the distinction.
Most tools follow a verb_noun pattern (update_note, delete_note, search_notes, list_notes, get_note_metadata, create_note, read_note), but list_notes_sorted deviates by adding a modifier, breaking consistency.
Eight tools is reasonable for a note management server, covering core operations. However, list_notes_sorted is arguably redundant, making the set slightly over-specified.
The tools provide full CRUD coverage (create, read, update, delete) plus search, listing, sorting, and metadata retrieval, covering the essential operations for managing notes in an Obsidian vault without obvious gaps.
Personal context for every AI: search, read, and write back to your private Markdown library.
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Your Valutorio Markdown notes, readable and writable by your AI. Needs Valutorio Sync.
Search your Obsidian vault to quickly find notes by title or keyword, summarize related content, a…
