# scrapbox-mcp
MCP server for Scrapbox API.
## Run
```bash
bunx @r_masseater/scrapbox-mcp@latest
```
## Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| `SCRAPBOX_PROJECT` | ✓ | Project name |
| `SCRAPBOX_COOKIE` | ✓ | Value of `connect.sid` cookie |
| `SCRAPBOX_PRESET` | | Tool preset (see below) |
| `SCRAPBOX_TOOLS` | | Comma-separated list of tools to enable |
| `SCRAPBOX_ENABLE_DELETE` | | Set `true` to enable delete_page |
### Getting the Cookie
1. Log in to [scrapbox.io](https://scrapbox.io)
2. DevTools (F12) → **Application** → **Cookies** → `https://scrapbox.io`
3. Copy the value of `connect.sid`
### Tool Presets
Select available tools with `SCRAPBOX_PRESET`:
| Preset | Tools |
|--------|-------|
| `minimal` | list_pages, get_page |
| `readonly` | list_pages, get_page, search_pages, get_links, get_backlinks |
| `full` (default) | All tools (delete_page requires `SCRAPBOX_ENABLE_DELETE=true`) |
Custom selection: `SCRAPBOX_TOOLS=list_pages,get_page,search_pages`
## Available Tools
### Read
| Tool | Description |
|------|-------------|
| `list_pages` | List all pages in the project |
| `get_page` | Get page content (Scrapbox notation) |
| `search_pages` | Full-text search |
| `get_links` | Get outgoing links from a page |
| `get_backlinks` | Get backlinks to a page |
### Write
| Tool | Description |
|------|-------------|
| `create_page` | Create a new page |
| `update_page` | Update an existing page (full replacement) |
| `insert_lines` | Insert lines at a specific position (or append to end) |
| `delete_page` | Delete a page (requires `SCRAPBOX_ENABLE_DELETE=true`) |
