Obsidian Integration
Manage Obsidian vault notes using file operations.
Obsidian Vault Structure
Typical vault location:
- macOS:
~/Documents/Obsidian Vault/ - Linux:
~/Documents/Obsidian Vault/ - Windows:
C:\Users\{user}\Documents\Obsidian Vault\
Available Tools
- read_file: Read note content
- write_file: Create or update notes
- edit_file: Modify existing notes
- bash: Search notes with grep/ripgrep
- web_fetch: Access Obsidian API (if REST API plugin installed)
Common Operations
Search Notes
rg "search term" ~/Documents/ObsidianVault/
Create Note
# Write to: ~/Documents/ObsidianVault/NewNote.md
content = """---
tags: [tag1, tag2]
created: 2026-01-27
---
# Note Title
Note content here...
"""
write_file(path="~/Documents/ObsidianVault/NewNote.md", content=content)
Update Note
Use edit_file to modify existing notes.
Link Notes
Obsidian uses [[Note Name]] for internal links.
Frontmatter
Obsidian notes support YAML frontmatter:
---
tags: [personal, work]
created: 2026-01-27
updated: 2026-01-27
---
Usage Examples
User: "Create a note about the meeting"
- Ask for note details
- Format with frontmatter
- Write to vault using write_file
User: "Search my notes for Python"
- Use bash with rg/grep
- Parse results
- Present formatted list
User: "Update my daily note"
- Read current daily note
- Append new content
- Write back
Configuration
Set vault path in your queries or config:
VAULT_PATH = "~/Documents/ObsidianVault/"