daniele-chiappa

Gosidian — AI skill for Claude Code

AI community

Self-hosted Obsidian-compatible markdown vault with a first-class MCP server for AI agents.

How to install Gosidian

This entry records only its repository, not the path inside it, so there is no exact command to give. Open daniele-chiappa/gosidian and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Gosidian does

Self-hosted Obsidian-compatible markdown vault with a first-class MCP server for AI agents.

Alternatives in AI

Claudian — An Obsidian plugin that embeds Claude Code as an AI collaborator in your vault 7.7k ★
WindsurfAPI — Turn Windsurf / Devin Desktop's 100+ AI models (Claude, GPT, Gemini, DeepSeek, Kimi, GLM, SWE) into OpenAI-, A 3k ★
Dinotty — Multi-device terminal server for AI coding agents 643 ★

README

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.

**Listed on** the [official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=gosidian) as `io.github.daniele-chiappa/gosidian`, [Glama](https://glama.ai/mcp/servers/daniele-chiappa/gosidian) and [mcpservers.org](https://mcpservers.org/servers/daniele-chiappa/gosidian) [![Glama score](https://glama.ai/mcp/servers/daniele-chiappa/gosidian/badges/score.svg)](https://glama.ai/mcp/servers/daniele-chiappa/gosidian) [![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/daniele-chiappa/gosidian)

![gosidian in action](docs/demo.gif)

Try it in your browser

[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/daniele-chiappa/gosidian)

Launch a free, throwaway gosidian in [GitHub Codespaces](https://github.com/features/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](docs/getting-started.md).