Obsidian Notes
If $ARGUMENTS is provided, treat it as the user's note request and proceed directly without asking for clarification.
Overview
Standard operations for reading, writing, and organizing notes in the Obsidian vault (Obsidian Flavored Markdown with YAML frontmatter and wikilinks). All vault operations use Obsidian MCP tools with vault-relative paths.
Companion Skills
Obsidian supports more than plain markdown notes. Before proceeding, consider whether the user's request is better served by one of these formats:
| Skill | Format | When to use | |-------|--------|-------------| | obsidian-markdown | .md | Always invoke when creating or editing notes — ensures correct Obsidian Flavored Markdown (wikilinks, callouts, embeds, properties) | | obsidian-bases | .base | User wants a database view, filtered table, card gallery, or summary of notes by properties | | json-canvas | .canvas | User wants a visual layout — mind map, flowchart, project board, or spatial arrangement of ideas |
Invoke the relevant skill(s) before writing content so you follow the correct syntax.
Directory Structure
Top-level categories: Work/, Dev/, Games/, Personal/, Travel/, DailyNote/
- Max depth: 3 levels for general notes
- Exception: Projects and Meetings allow 4 levels
Special Note Types (use templates)
| Type | Path pattern | Template | |------|-------------|----------| | Project | Work/Projects/[ProjectName]/[ProjectName].md | assets/project.md | | Meeting | Work/Meetings/YYYY/MM/[title] YYYY-MM-DD.md | assets/meeting.md | | DailyNote | DailyNote/YYYY/MM/YYYY-MM-DD.md | Use get_periodic_note, append_periodic_note, patch_periodic_note |
Note Creation Checklist
- Determine note type (project / meeting / daily / general)
- Select template if applicable
- Create with
create_note(path, content) - Verify frontmatter fields:
title,created,updated,tags - Verify creation:
read_note(path)to confirm file was created and YAML is valid
Reference Files
| File | When to read | |------|-------------| | references/note-organization.md | Naming, tag system, frontmatter standards | | references/tool-selection.md | Unsure which tool to use | | references/error-handling.md | File not found, YAML errors, search returns nothing | | references/meeting-workflow.md | Any meeting note operation (create, query, update status) | | references/project-workflow.md | Any project note operation (query, create, update, Jira integration) |