Skip to content
MCP server

gosidian

Self-hosted Markdown vault with a web UI and an 81-tool MCP server for agents

Install
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.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gosidian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/daniele-chiappa/gosidian:v2.164.1"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gosidian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/daniele-chiappa/gosidian:v2.164.1"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers