Smart Composer

Documentation · Report Bug · Discussions

[!NOTE] What's New

v1.2.8 — Connect your Gemini account

v1.2.7 — Connect your Claude or OpenAI account directly (no API key required)

v1.2.6 — Support for GPT-5.2, Opus 4.5, Gemini 3, and Grok 4.1

🔌 MCP Support — Connect Smart Composer to external tools and data sources via the Model Context Protocol

[!WARNING] ⚠️ Maintenance Notice

This plugin is currently maintained by a single developer and is not under active development.
Occasional updates or bug fixes may still be released, but issues and feature requests may not be reviewed promptly.

🔗 Community Forks
A list of community-maintained forks is available in the Community Fork Collection.
If you're maintaining a fork, feel free to add it there. And if you're simply interested in exploring alternative versions, you're welcome to check it out as well.

Risks of connecting a Claude subscription

As of January 2026, Anthropic has restricted third-party OAuth access, citing Terms of Service violations.

Smart Composer's subscription connect uses the same OAuth-style flow that tools like OpenCode have used. There are reports of Claude accounts being banned or restricted when subscription OAuth is used via third-party clients (example: https://github.com/anomalyco/opencode/issues/6930). For OpenAI (ChatGPT) and Google (Gemini), I have not seen comparable ban reports so far, but this is still not the same as official API access, and enforcement can change at any time.

Use at your own risk. Keep usage limited to personal, interactive sessions and avoid any automation.

Everytime we ask ChatGPT, we need to put so much context information for each query. Why spend time putting background infos that are already in your vault?

Smart Composer is an Obsidian plugin that helps you write efficiently with AI by easily referencing your vault content. Inspired by Cursor AI and ChatGPT Canvas, this plugin unifies your note-taking and content creation process within Obsidian.

Features

Contextual Chat

Upgrade your note-taking experience with our Contextual AI Assistant, inspired by Cursor AI. Unlike typical AI plugins, our assistant allows you to precisely select the context for your conversation.

• Type @<fname> to choose specific files/folders as your conversation context
• Get responses based on selected vault content

Multimedia Context

Now, you can add website links and images as additional context for your queries.

• Website content is automatically extracted
• Image support: Add images directly to your chat through:
  • Upload button
  • Drag & drop
  • Paste from clipboard
• Youtube link support: YouTube transcripts are fetched and included as context
• Coming soon: Support for external files (PDF, DOCX, ...)

Apply Edit

Smart Composer suggests edits to your document. You can apply with a single click.

• Offers document change recommendations
• Apply suggested changes instantly

Vault Search (RAG)

Automatically find and use relevant notes from your vault to enhance AI responses.

• Hit Cmd+Shift+Enter to run Vault Search answer
• Semantic search across your vault to find the most relevant context

Model Context Protocol (MCP)

Connect Smart Composer to external MCP servers. MCP lets you use powerful third-party tools and data sources right inside your chat.

Additional Features

• Custom Model Selection: Use your own model by setting your API Key (stored locally). Supported API providers:
  • OpenAI
  • Anthropic
  • Google (Gemini)
  • Groq
  • DeepSeek
  • OpenRouter
  • Azure OpenAI
  • Ollama
  • LM Studio
  • MorphLLM
  • Any other OpenAI-compatible providers
• Local Model Support: Run open-source LLMs and embedding models locally with Ollama for complete privacy and offline usage.
• Custom System Prompts: Define your own system prompts that will be applied to every chat conversation.
• Prompt Templates: Create and reuse templates for common queries by typing / in the chat view. Perfect for standardizing repetitive tasks.
  • Create templates from any selected text with one click

Getting Started

[!IMPORTANT] Installer Version Requirement
Smart Composer requires a recent version of the Obsidian installer. If you experience issues with the plugin not loading properly:

1. First, try updating Obsidian normally at Settings > General > Check for updates.

2. If issues persist, manually update your Obsidian installer:

   • Download the latest installer from Obsidian's download page
   • Close Obsidian completely
   • Run the new installer

1. Open Obsidian Settings
2. Navigate to "Community plugins" and click "Browse"
3. Search for "Smart Composer" and click Install
4. Enable the plugin in Community plugins
5. Set up Smart Composer in plugin settings:
   • Connect subscription (no API key): Connect your Claude/OpenAI account in Settings > Smart Composer > Connect your subscription
   • API Providers (usage-based billing): Add an API key in Settings > Smart Composer > Providers
     • OpenAI: ChatGPT API Keys
     • Anthropic: Claude API Keys
     • Gemini: Gemini API Keys

[!TIP] Looking for a free option?
Gemini API provides the best performance among free models for Smart Composer. Recommended for users looking for a free option. When using free APIs, please review the provider’s privacy policy before sending sensitive data.

📚 For detailed setup instructions and documentation, please visit our Documentation.

Roadmap

To see our up-to-date project roadmap and progress, please check out our GitHub Projects kanban board.

Some of our planned features include:

• Support for external files (PDF, DOCX, etc.)
• Mentioning with tags or other metadata

Feedback and Support

We value your input and want to ensure you can easily share your thoughts and report any issues:

• Bug Reports: If you encounter any bugs or unexpected behavior, please submit an issue on our GitHub Issues page. Be sure to include as much detail as possible to help us reproduce and address the problem.

• Feature Requests: For new feature ideas or enhancements, please use our GitHub Discussions - Ideas & Feature Requests page. Create a new discussion to share your suggestions. This allows for community engagement and helps us prioritize future developments.

• Show and Tell: We love seeing how you use Smart Composer! Share your unique use cases, workflows, or interesting applications of the plugin in the GitHub Discussions - Smart Composer Showcase page.

Your feedback and experiences are crucial in making Smart Composer better for everyone!

Contributing

We welcome all kinds of contributions to Smart Composer, including bug reports, bug fixes, documentation improvements, and feature enhancements.

For major feature ideas, please create an issue first to discuss feasibility and implementation approach.

If you're interested in contributing, please refer to our CONTRIBUTING.md file for detailed information on:

• Setting up the development environment
• Our development workflow
• Working with the database schema
• The process for submitting pull requests
• Known issues and solutions for developers

Contributors

Core Team

These contributors were instrumental in shaping the initial vision, architecture, and design of Smart Composer:

@glowingjade (Twitter), @kevin-on, @realsnoopso (Twitter · LinkedIn), @woosukji

Additional Contributors

We also want to thank everyone else who has contributed. Your time and effort help make Smart Composer better for everyone!

License

This project is licensed under the MIT License.

Support the Project

If you find Smart Composer valuable, consider supporting its development:

Follow me on X (Twitter) @andy_suh_ for updates and announcements!

Your support helps maintain and improve this plugin. Every contribution is appreciated and makes a difference. Thank you for your support!

Star History