gosidian
Self-hosted Markdown vault with a web UI and an 81-tool MCP server for agents
- Pricing
- Open source
- Platforms
- self-hosted, Web
- Runs
- Remotely
- Version
- 2.164.1
- Listing updated
- today
Similar MCP servers
About gosidian
gosidian is an open-source MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.
Notes live as plain .md files on disk, so the same folder opens in Obsidian, VS Code or vim. A single Go binary serves a Vue web UI and the MCP server, and a SQLite FTS5 index acts only as a cache that can be rebuilt. The web UI uses a tiling workspace called plancia, with notes, graph, search and config forms as side-by-side windows.
For agents, the README lists 81 typed tools covering session bootstrap, ingesting files, search, read, write, linking, handoffs, self-checks and audit. Bearer tokens carry read or write scope and can be restricted per project; OAuth grants are also supported, and each request is narrowed to what the owning account may access. Retrieval is by path, tag, frontmatter and backlinks, not embeddings: semantic search is deliberately deferred, with an experimental RAG for documents.
It starts with one Docker command, then you create an admin, copy a token from /admin/tokens and add the server to your client. The README lists missing pieces plainly: no mobile app, no real-time collaboration, no hosted tier.
Install
Run in a terminal
claude mcp add gosidian -- docker run -i --rm ghcr.io/daniele-chiappa/gosidian:v2.164.1Add to claude_desktop_config.json
{
"mcpServers": {
"gosidian": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/daniele-chiappa/gosidian:v2.164.1"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gosidian": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/daniele-chiappa/gosidian:v2.164.1"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"gosidian": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/daniele-chiappa/gosidian:v2.164.1"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gosidian": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/daniele-chiappa/gosidian:v2.164.1"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gosidian": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/daniele-chiappa/gosidian:v2.164.1"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
GOSIDIAN_VAULTVault path inside the container
What it does
- Markdown-first vault
- Plain files, zero lock-in; remove .gosidian/ and you have an Obsidian vault.
- 81 typed tools
- Bootstrap, ingest, search, read, write, link, handoff, self-check and audit for agents.
- Scoped tokens
- Read/write scopes, per-project restriction and account-narrowed access.
- Multi-user workspace
- Per-project visibility and grants for accounts and teams, plus an audit trail.
- Web UI
- Editor with live preview, graph view, backlinks and full-text search.
- Agent handoffs
- An orchestration bus for passing work between agents.
Good for
- Give coding agents persistent notes, plans and decision records
- Share one vault between a team and their agents with permissions
- Add an automation layer to an existing Obsidian vault
- Keep session digests from Claude Code hooks
Pricing
Open source
Self-hosted; no hosted tier
gosidian FAQ
How do I run it?
docker run the ghcr.io/daniele-chiappa/gosidian image, create an admin at localhost:8080 and copy the MCP token.
Does it need Obsidian?
No. It runs headless, though the vault stays compatible with Obsidian.
Does it use vector search?
No by design; retrieval is by identity, tags and links, with an experimental RAG for documents.
Is there a hosted version?
No. The README lists a hosted offering as a gap.
Is gosidian free?
Yes. gosidian is open source, so you can use and self-host it for free.
How do I add gosidian to Claude Code?
Run this command in your terminal: claude mcp add gosidian -- docker run -i --rm ghcr.io/daniele-chiappa/gosidian:v2.164.1
What are the best alternatives to gosidian?
The closest alternatives to gosidian are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and NeuroStack.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.



