gosidian MCP server

gosidian

Markdown notes your AI agents can read, write, and reason over — via MCP.

A self-contained markdown vault with a built-in MCP server. Humans edit through a web UI, agents talk to it over MCP, everything lives in plain .md files that Obsidian (and every other markdown tool) reads natively.

Try it in your browser

Launch a free, throwaway gosidian in GitHub Codespaces — no install, running on your own Codespaces quota. It builds from source, seeds a small demo vault, and opens the web UI. Log in with demo / gosidian-demo.

Quick start

docker run -d --name gosidian \
  -p 8080:8080 \
  -v "$(pwd)/vault:/vault" \
  ghcr.io/daniele-chiappa/gosidian:latest
# open http://localhost:8080, create admin, copy the MCP token from /admin/tokens
claude mcp add gosidian http://localhost:8080/mcp \
  --transport http --header "Authorization: Bearer $TOKEN"

Three commands: Docker up → token created from the web UI → agent wired. Your .md vault is persisted under ./vault/; stop the container and the files are still there.

Other installation paths (source, custom compose, bare-metal): docs/getting-started.md.

What is gosidian

folder in Obsidian, VS Code, vim, or any editor you already use. Zero lock-in: delete .gosidian/ and you have a pure Obsidian vault.

• A markdown vault. Notes are .md files on disk. Open the same

search, read, write, link, handoff, self-check, audit. Bearer-token authentication with per-project scoping.

• An MCP server. 57 typed tools let agents bootstrap a session, ingest files,

(built with Vite, embedded via go:embed). Notes, graph, search and config forms open as windows in a tiling "plancia" workspace — full-text search, backlinks, graph view, editor with live preview, audit trail, admin pages for tokens and users.

• A web UI. A Vue 3 single-page app served from the same binary

All three views hit the same files on disk. The SQLite FTS5 index is a cache — drop it and it rebuilds.

Who it's for

memory: note-taking, plans, skills, ADRs, handoffs, audit.

• AI engineers wiring agents that need persistent structured

they already trust.

• Obsidian users who want a programmable layer on top of a vault

• Teams with shared vault + per-project scoped tokens per agent.

Why gosidian instead of X

tag, frontmatter, backlinks) — more predictable than similarity search for an agent's working memory. Semantic search is deliberately deferred: see ADR-007 rationale.

• vs RAG / vector search: gosidian retrieves by identity (path,

gosidian adds a typed automation surface (MCP) to the same vault. Not competitive — complementary.

• vs Obsidian Sync: Sync mirrors a vault between human devices.

a project. gosidian's vault is already .md files you can take anywhere.

• vs Notion / Roam: hosted or proprietary formats; migration is

FAQ covers the long form.

Feature highlights

Shortened. The full README is on GitHub.