A powerful Obsidian plugin that brings AI assistant capabilities directly into your note-taking workflow. Chat with AI, manage tools, and enhance your productivity without leaving Obsidian.
- Natural Conversations - Chat with AI using state-of-the-art language models
- Context Aware - Automatically includes current note and related notes in conversations
- Multi-Model Support - DeepSeek, OpenAI, Anthropic, Moonshot, Google Gemini, and more
- Image Support - Paste images from clipboard into conversations
- Built-in Tools - Time, note reading/writing, file editing, web search, local search, command execution, and more
- MCP Servers - Extend with Model Context Protocol servers
- SubAgents - Create specialized AI assistants for specific tasks
- Tool Management - Enable/disable tools with granular permissions
- Customizable API endpoints, temperature, max tokens
- Persistent settings across sessions
- Per-model configuration support
- Install and enable the BRAT plugin from the Obsidian Community Plugins.
- Open BRAT settings, click "Add Beta plugin".
- Enter the repository address:
https://github.com/bearcatat/obsidian-agent - Click "Add Plugin".
- Once installed, go to Obsidian Settings -> Community Plugins and enable "Obsidian Agent".
- Download the latest release from GitHub Releases
- Extract to
.obsidian/plugins/obsidian-agent/ - Reload Obsidian and enable the plugin
- Open the Plugin - Click the icon in the left sidebar or use the command palette
- Configure a Model - Add your API key in Settings β Obsidian Agent β Models
- Start Chatting - Type your question and press Enter
- Add Context - Drag notes or paste images to include them in the conversation
Simply type your question and press Enter. The AI will automatically analyze your current note and respond intelligently.
- Notes - Drag and drop notes or click "Add Context" to include them
- Images - Paste images (Ctrl+V) to add visual context
- Active Note - The currently open note is automatically included
Ask naturally and the AI will use appropriate tools:
- "Find all notes mentioning 'project plan'"
- "Help me improve this note's structure"
- "Search for TODO items in my journal"
Create specialized assistants for specific workflows:
- Go to Settings β Obsidian Agent β SubAgents
- Click "Add SubAgent"
- Define the system prompt and select tools
| Provider | Direct API | Notes |
|---|---|---|
| DeepSeek | β | Full support |
| OpenAI | β | Including compatible APIs |
| Anthropic | β | No thinking mode |
| Moonshot | Enable "Use CORS Proxy" in model settings | |
| Google Gemini | β | Full support |
| OpenAI Compatible | β | Support for OpenAI-compatible APIs |
Extend functionality with external tools:
- Settings β Obsidian Agent β MCP Servers
- Add server configuration (stdio/http/sse)
- Enable desired tools from each server
This project is licensed under the AGPL-3.0 license.
- obsidian-copilot by @logancyang
- opencode
Made with β€οΈ for the Obsidian community