# gosidian

> gosidian is an open-source MCP server for knowledge and memory. Self-hosted Markdown vault with a web UI and an 81-tool MCP server for agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, Web
- **Repository:** https://github.com/daniele-chiappa/gosidian
- **MCP Registry name:** io.github.daniele-chiappa/gosidian
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add gosidian -- docker run -i --rm ghcr.io/daniele-chiappa/gosidian:v2.164.1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gosidian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/daniele-chiappa/gosidian:v2.164.1"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gosidian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/daniele-chiappa/gosidian:v2.164.1"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gosidian": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/daniele-chiappa/gosidian:v2.164.1"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gosidian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/daniele-chiappa/gosidian:v2.164.1"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gosidian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/daniele-chiappa/gosidian:v2.164.1"
      ]
    }
  }
}
```

## 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.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Digitalnz](https://ai-powered.com/mcp/digitalnz): Digitalnz is a freemium MCP server for knowledge and memory.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/gosidian
