# slivingdoc

> slivingdoc is a freemium MCP server for knowledge and memory. Shared notes for agents and people, merged Git-style and stored in S3. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $1 a month
- **Platforms:** CLI, self-hosted, Web, macOS, Linux
- **Website:** https://slivingdoc.dev
- **Repository:** https://github.com/baalimago/slivingdoc
- **MCP Registry name:** io.github.baalimago/slivingdoc
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

slivingdoc gives agents a notebook that outlives any single session. Agents and humans pull a directory of plain UTF-8 text files, edit them with ordinary file tools, then commit; concurrent edits to different lines merge, and the same line becomes a reported conflict instead of an overwrite.

Storage is either a hosted space on slivingdoc.dev or your own S3-compatible bucket that supports conditional writes. The README and site describe uses such as shared context across Claude Code and Codex, fleets of agents that each commit a report, and memory for CI jobs and sandboxes that lose their disk after every run. Access rules can mark paths read-only so instructions can be changed at runtime.

The MCP server runs over stdio via npx. The pull operation is exposed as notes_pull, with a matching CLI command. The project is MIT licensed.

## Features

- **Git-style merging:** Merges non-conflicting concurrent edits and reports conflicts.
- **Plain text checkout:** Notes are ordinary files you pull into a directory.
- **Your bucket or hosted:** Use any S3-compatible bucket or a hosted space on slivingdoc.dev.
- **Path permissions:** Choose where agents may read and where they may write.
- **MCP and CLI:** The same pull and commit operations are available both ways.
- **Invite sharing:** Hosted spaces can be shared with invite links.

## Good for

- Keep one shared context for several coding agents
- Give CI agents memory between runs
- Collect reports from a fleet of agents in one place
- Change agent instructions without redeploying
- Share notes between colleagues from the command line

## Install

### Claude Code (Terminal)

```sh
claude mcp add slivingdoc --env SLIVINGDOC_TOKEN='<SLIVINGDOC_TOKEN>' -- npx -y slivingdoc
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "slivingdoc": {
      "command": "npx",
      "args": [
        "-y",
        "slivingdoc"
      ],
      "env": {
        "SLIVINGDOC_TOKEN": "<SLIVINGDOC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "slivingdoc": {
      "command": "npx",
      "args": [
        "-y",
        "slivingdoc"
      ],
      "env": {
        "SLIVINGDOC_TOKEN": "<SLIVINGDOC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "slivingdoc": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "slivingdoc"
      ],
      "env": {
        "SLIVINGDOC_TOKEN": "<SLIVINGDOC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "slivingdoc": {
      "command": "npx",
      "args": [
        "-y",
        "slivingdoc"
      ],
      "env": {
        "SLIVINGDOC_TOKEN": "<SLIVINGDOC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "slivingdoc": {
      "command": "npx",
      "args": [
        "-y",
        "slivingdoc"
      ],
      "env": {
        "SLIVINGDOC_TOKEN": "<SLIVINGDOC_TOKEN>"
      }
    }
  }
}
```

## Tools

- `notes_pull`: Pulls the shared notebook into the server's directory, merging unpublished local edits with the accepted state.

## FAQ

### What does hosting cost?

Free for one space with 10 MiB and 250,000 requests a month; extra spaces, storage and requests are $1 a month each step.

### Can I self-host?

Yes, for free, against your own S3-compatible bucket with conditional writes.

### What happens at a usage limit?

At the storage limit new commits are refused while pulls keep working; at the request limit commits are refused and reads slow down.

### Are binary files supported?

No. The pricing page says text files only.

### Is slivingdoc free?

slivingdoc has a free plan, with paid plans for more usage or features. Paid plans start at $1 a month.

### How do I add slivingdoc to Claude Code?

Run this command in your terminal: claude mcp add slivingdoc --env SLIVINGDOC_TOKEN='<SLIVINGDOC_TOKEN>' -- npx -y slivingdoc

### What are the best alternatives to slivingdoc?

The closest alternatives to slivingdoc are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## 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.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

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