pasteai

Quickstart

Run `/setup` in Claude Code — it installs the binary and configures MCP. Then restart your editor to activate.

Or install manually:

# macOS
brew install pasteai/pasteai/pasteai

# Windows
scoop bucket add pasteai https://github.com/pasteai/scoop-pasteai
scoop install pasteai

# Linux (Debian/Ubuntu)
# Download the .deb from https://github.com/pasteai/pasteai/releases/latest

# Any platform — prebuilt binary
curl -sSL https://raw.githubusercontent.com/pasteai/pasteai/main/install.sh | sh

# With Go
go install github.com/pasteai/pasteai/cmd/pasteai@latest

Then run `pasteai setup` to register with your AI editor(s). It configures Claude Code, Kiro, and opencode simultaneously.

To configure manually, add the entry to the appropriate config file:

Claude Code (`~/.claude.json`) and Kiro (`~/.kiro/settings/mcp.json`):

{
  "mcpServers": {
    "pasteai": {
      "command": "/full/path/to/pasteai",
      "args": ["mcp"]
    }
  }
}

opencode (`~/.config/opencode/opencode.json`):

{
  "mcp": {
    "pasteai": {
      "type": "local",
      "command": ["/full/path/to/pasteai", "mcp"]
    }
  }
}

Use the absolute path from `which pasteai` or `$(go env GOPATH)/bin/pasteai` — AI editors do not inherit your shell PATH.

Restart your editor, then ask: *"Summarise what we discussed and publish it."*

CLI Reference

Which mode?

Three Modes

1. Embedded (zero config)

Add the MCP config above and restart Claude Code. When Claude first calls a tool, PasteAI starts a local server automatically. Documents stored at `~/.pasteai/documents.db` and as plain markdown files at `~/.pasteai/documents/{id}.md` — readable without the server running.

2. Local server

Run the server persistently with Docker Compose and point the MCP client at it:

# docker-compose.yml
services:
  pasteai:
    image: ghcr.io/pasteai/pasteai:latest
    ports:
      - "8080:8080"
    volumes:
      - ${HOME}/.pasteai:/data
    restart: unless-stopped

mkdir -p ~/.pasteai
docker compose up -d

In `~/.claude.json`:

{
  "mcpServers": {
    "pasteai": {
      "command": "/full/path/to/pasteai",
      "args": ["mcp"],
      "env": { "PASTEAI_URL": "http://localhost:8080" }
    }
  }
}

Good when you want the server always running, independent of Claude Code. For systemd, launchd, or nohup alternatives, see docs/server-setup.md.

3. Remote

Point `PASTEAI_URL` at any PasteAI instance. Both `PASTEAI_API_KEY` and `-base-url` are required on the server for remote access to work correctly.

Start the server with:

pasteai serve -api-key  -base-url https://your-server.example.com

In `~/.claude.json`:

{
  "mcpServers": {
    "pasteai": {
      "command": "/full/path/to/pasteai",
      "args": ["mcp"],
      "env": {
        "PASTEAI_URL": "https://your-server.example.com",
        "PASTEAI_API_KEY": "your-key"
      }
    }
  }
}

Tailscale

To read documents from your phone or another machine, use Tailscale. Start `pasteai serve`, then browse to `http://:8080` from any device on your tailnet. Set `-base-url http://:8080` so document links resolve correctly.

MCP Tools

`publish_document` — publish a markdown document, returns a shareable URL.

`list_documents` — returns recent public documents.

`get_document` — retrieve a document by ID, including its full markdown content.

`update_document` — update the title or content of an existing document.

`delete_document` — permanently delete a document by ID.

claude.ai Custom Connectors (streamable-HTTP MCP)

To connect a deployed PasteAI server to claude.ai as a Custom Connector, start the server with `-enable-mcp-http`. This mounts a stateless streamable-HTTP MCP endpoint at `/mcp` alongside the web UI:

pasteai serve \
  -api-key  \
  -base-url https://your-server.example.com \
  -enable-mcp-http

Then in claude.ai → Settings → Connectors, add:

https://your-server.example.com/mcp

The `/mcp` endpoint requires the same Bearer token as the API when `-api-key` is set. The stdio transport (`pasteai mcp`) is unaffected — both can run simultaneously.

REST API

curl -X POST http://localhost:8080/api/documents \
  -H 'Content-Type: application/json' \
  -d '{"title": "My Report", "content": "# Hello\n\nThis is my report.", "author": "Claude"}'

Response includes a `url` field: `http://localhost:8080/d/{id}`

Themes

Switch themes using the selector in the top nav. Choice is saved in `localStorage`.

Light · Dark · Emerald · Arctic · Catppuccin Mocha · Catppuccin Latte · Catppuccin Frappé

Contributing & License

CONTRIBUTING.md · MIT License