| last_updated | 2026-04-30 |
|---|---|
| status | active |
Turn Obsidian into a tool that reaches beyond PKM, notetaking, storage, and organization. Safely extend it to match how you think, and what you do. You're in control and everything happens using regular, conversational language — write, plan, build custom commands, even develop Obsidian plugins — without leaving Obsidian.
| You ask… | ObsidiBot does… |
|---|---|
| "Summarize my meeting notes from last week" | Creates a summary note and opens it in your editor |
| "Rename all my untitled notes based on their content" | Finds them, renames them, reports back |
| "Find writing residencies in the US with open applications this year and draft a summary of costs and deadlines" | Searches the web, compiles results, writes the summary note |
| "Turn this page into a Canvas mind map" | Generates a .canvas file from your note |
| "Create a skill that summarizes my weekly notes into a report" | Writes the skill file — available instantly as a / slash command, Ctrl+P command, and callable by any plugin or script |
Note
Status: Public beta — Feedback welcome on Discord. Currently submitted for inclusion as an Obsidian Community Plugin — awaiting review.
*Requirements:
- Obsidian desktop (Windows, Mac, Linux — no mobile support)
- Claude Code CLI installed and authenticated — included in Claude Pro/Max subscriptions. (Windows,: install in PowerShell. Mac/Linux: use
curl -fsSL https://claude.ai/install.sh | bash)
- Install BRAT from the Obsidian community plugin browser
- In BRAT settings → Add Beta Plugin →
ScottKirvan/ObsidiBot
- Download
obsidibot-<version>.zipfrom Releases - Extract to
<your-vault>/.obsidian/plugins/obsidibot/ - Settings → Community Plugins → enable ObsidiBot
- Open the ObsidiBot panel from the ribbon (brain/circuit icon) or Command Palette:
ObsidiBot: Open agent panel - Type a message (ie. "Hi! Tell me about yourself.") and press Enter
- See the User Guide for details on Skills, session management, and settings
🔧 Create custom commands — expand Obsidian's capabilities
Skills are the "bot" in ObsidiBot. Write a natural language prompt, save it as a markdown file in your commands folder, and it becomes a first-class command — available in the '/' slash menu, in the Obsidian command palette with hotkey support, and exposed as an API endpoint, callable by any plugin or script within Obsidian.
Add YAML frontmatter and Skills grow into parameterized forms that can prompt for input: dropdowns, text inputs, note pickers with fuzzy search. Your most-compicated recurring workflows become generalized, reusable, one-click operations.
→ Learn about Skills
✏️ Deep Obsidian integration
ObsidiBot isn't a chat window bolted onto Obsidian. It integrates with Obsidian:
- Obsidian UI control — opens files, splits panes, navigates headings, shows notifications
- Run any command — execute anything from the command palette; and you control which commands are allowed and which aren't
- Live vault graph — Claude can query backlinks, outlinks, tags, and file lists mid-reasoning
- Canvas — reads and generates
.canvasfiles natively
→ Full feature list
🔒 Your vault, your rules
- Configurable safety modes — readonly, standard, full access; blocked operations show an in-chat card with one-click upgrade
- Per-note frontmatter controls — pin notes to every session, inject per-note instructions, all via Obsidian Properties
- Vault-native memory —
_claude-context.mdpersists context across sessions and syncs across machines - Context gauge — live session memory indicator below the input; one-click compaction
🌐 Reach beyond your vault
ObsidiBot doesn't stop at the edges of your vault. Given proper permissions (which you control), it can search the web, work with files anywhere on your system, and interact with external services — and everything it finds comes back as a note, woven into your vault where it belongs.
- Web search — Claude can search the web mid-conversation and bring results back as chat responses or notes
- Filesystem access — ObsidiBot, under your direction, can read, write, and organize files anywhere on your system, not just inside the vault
- External services — Home automation, calendar/weather, GitHub, etc. For example, ObsidiBot can manage GitHub issues, pull in data, run CLI tools — all from a single conversational interface
- Your vault as hub — everything that comes in lands where you decide, searchable and linked
ObsidiBot is free, open source, and built in spare time. If it's useful:
See CONTRIBUTING.md for project layout, development setup, and PR process.
MIT — see LICENSE.md
