Connecting Your Obsidian Vault

Your agent can read, search, and edit notes in your personal Obsidian vault — a "second brain" it can draw on in your own chats. This runs through the Tools (MCP) system, so it only works in conversations you have with your own agent, never with visitors.

Obsidian doesn't offer one official way to do this — it depends on a plugin exposing your vault over a network, and which plugin you pick determines which devices work. There are two supported paths.

Path 1: Local REST API (desktop only)

The most established option. Works great if you mainly use Obsidian on a Mac, Windows, or Linux machine.

1. In Obsidian, go to Settings → Community plugins → Browse, search for Local REST API, install and enable it.
2. Open its settings and copy your API key.
3. This plugin only listens on your own machine (localhost) — to let your agent reach it, expose it with a stable public URL using a tunnel like Tailscale Funnel or a named Cloudflare Tunnel. (Skip "quick" tunnels — their URL changes every time you restart them.)
4. Your endpoint is https://<your-tunnel-host>/mcp/.

Limitation: this only works while that specific desktop is on, Obsidian is open, and the tunnel is running. It cannot work on mobile — Obsidian's iOS and Android apps don't allow plugins to run a local network server, so this isn't something we or the plugin author can fix, it's a platform restriction.

Path 2: Fast Note Sync (all devices, including iPhone)

If you take notes across your phone and desktop and want your agent to see all of it, use Fast Note Sync instead. It's a real-time sync service your devices all connect to — including iOS and Android — and it ships its own MCP server, so your agent talks to the same always-on hub your notes already sync through.

1. Install the Fast Note Sync plugin on every device you take notes from.
2. Deploy the Fast Note Sync Service backend somewhere always-on (it ships as a Docker image — a small VPS or a NAS both work).
3. Authorize each device against that service from its web dashboard.
4. From the same dashboard, copy the service's MCP endpoint URL and an API token for your agent to use.

Trade-off: this is a newer, self-hosted, single-maintainer project — you're taking on the job of keeping that backend server running, in exchange for it working from your iPhone.

Connecting It in Agenturo

1. Open your admin dashboard → Tools (MCP) tab.
2. Find Obsidian under Popular servers and click Add.
3. Paste the MCP endpoint URL and API key from whichever path you set up above.
4. Click Connect — your agent verifies the connection immediately and tells you how many tools it found.

Which Path Should I Use?

• Only ever use Obsidian on a laptop or desktop? Local REST API is simpler and more battle-tested.
• Need your iPhone or Android notes included too? Fast Note Sync is the only path that covers them, at the cost of running your own backend.
• Already sync your vault into Google Drive or Dropbox for other reasons? You can also reach it through the Zapier tile instead of the Obsidian one, using the same custom-server flow.

A Note on Availability

Either path depends on something outside Agenturo staying reachable — your tunnel, or your sync server. If it's down, your agent quietly skips the Obsidian tool for that conversation and answers with what it already knows. Nothing else breaks.