← Back to directory
Y

YOLO

Community
Agent-native AI assistant for Obsidian — chat, write, knowledge base, and orchestration, all in one place.
Category
Collaboration #35 of 55
Stars
★ 1.4k Very popular
Transport
stdio (local process)
Runtime
Node.js
Credentials
API key / credential required
License
MIT
Last commit
Tools
1
50FMRS · D

YOLO offers powerful AI integration for Obsidian with rich features, but users must weigh network risks and plugin compatibility.

Strongest · Maintenance 14/20 Weakest · Reliability 6/20

Reliability
6/20
Security and permissions
10/20
Maintenance
14/20
Documentation
12/20
Setup experience
8/20
Why each score
Reliability 6/20
This is an Obsidian plugin, not a standard MCP server; no MCP manifest or tool list is provided. The core logic may be called via external MCP clients, but there is no clear evidence in the repository that it can independently complete the MCP handshake. Therefore, the reliability score is low.
Security and permissions 10/20
The plugin requires users to configure API keys (e.g., OpenAI, Anthropic), but no key leakage or malicious behavior was found. However, it involves external network requests and tool calls, lacking clear least-privilege principles. There is no obvious red-line risk, but security measures are incomplete.
Maintenance 14/20
The repository is active with regular commits and releases (latest version 1.6), has an MIT license, and responds to community feedback. However, there is no dedicated security response channel or dependency update strategy, which is a minor gap.
Documentation 12/20
The README provides installation, configuration, and feature descriptions, but lacks detailed tool parameters, limitations, costs, or troubleshooting guides. Documentation quality is good but not comprehensive.
Setup experience 8/20
Installation steps are clear (via community plugin store or manual), but require users to configure API keys additionally, and no configuration examples for mainstream MCP clients are provided. As a plugin, setup is simple, but as an MCP server, its integration method is unclear.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessReads local files

Best for

  • Heavy Obsidian users
  • Users needing an AI assistant integrated with personal notes
  • Learners
  • Users wanting AI in their writing workflow

Not for

  • Non-Obsidian users
  • Users needing a standalone AI service independent of Obsidian
  • Users requiring a local-first, cloud-independent solution

Required permissions

  • Read and write notes in your Vault
  • Access network to call AI APIs
  • Execute local commands (if desktop Bash enabled)
  • Call external tools and MCP servers

Risks and side effects

  • Requires network connection; note content may be sent to third-party AI services
  • Plugin conflicts with Smart Composer; must disable it
  • Misconfiguration may leak API keys

Setup

Before you start

Runtime:Node.js

  1. Open Obsidian Settings → Community Plugins → Browse → Search 'YOLO'.
  2. Install and enable.
  3. Configure your API key in plugin settings, or use your own ChatGPT OAuth / Gemini OAuth.
  4. Open the sidebar to start chatting — or try Quick Ask by typing '@' in the editor.

Manual install: Download main.js, manifest.json, styles.css from Releases, place them in <vault>/.obsidian/plugins/obsidian-yolo/.

Check that it works

Connect an MCP client such as Hermes or OpenClaw to YOLO and check that vault_search appears in the client's tool list; calling it with a keyword known to exist in the vault should return matching notes, confirming the connection.

Troubleshooting

  1. Ensure Obsidian is up to date
  2. Check network connection and API key validity
  3. If conflict occurs, disable Smart Composer and restart Obsidian
  4. Consult GitHub Issues for help

Things to try

Once connected, you can ask your AI assistant things like:

  • Search my vault for notes about spaced repetition and summarize the key points
  • Use vault_search to find all documents mentioning the FSRS algorithm
  • Look up notes related to Learning Mode in my vault and list the files

Tools 1

vault_search read-only
Search notes in your Obsidian Vault to get answers grounded in your personal knowledge.

Use cases

Chat and Q&A within Obsidian
RAG queries against your Vault knowledge base
Create learning projects with flashcards and FSRS review
Automate tasks with background agents
Handle multiple tasks in parallel with multi-window chat

Supported clients

Claude DesktopPartial support

Listed from the project's documentation, not tested by this site.

Overview

YOLO is a plugin for Obsidian delivering an agent-native AI experience. It can directly interact with your Vault, call tools and MCP servers, and use Skills to accomplish real tasks. It supports multiple models (OpenAI, Claude, Gemini, DeepSeek, etc.), offers Vault RAG, memory system, multi-window chat, background agents, and Learning Mode. It also allows external MCP clients (such as Hermes and OpenClaw) to connect to Vault search.

Similar servers

Source revision 9f4aaac84e7d Data synced 2026-10-11 Read the FMRS scoring method