Slabby MCP Server

🧱 Slabby

MCP server for Slab knowledge base integration with AI coding agents

Slabby is a Model Context Protocol server that enables AI coding agents like Claude Code, Cline, and others to read and update your Slab documentation directly. Perfect for keeping RFCs, technical docs, and team wikis in sync with your development workflow.

Features

• 📖 Read Slab posts - Fetch post content by ID or URL
• ✏️ Update Slab posts - Edit posts with changes attributed to you
• 🔍 Search Slab - Find posts across your workspace
• 📋 List posts - Browse posts by topic or tag
• 🔐 Secure authentication - Uses your personal Slab API token

Installation

For Development

git clone https://github.com/russwyte/slabby.git
cd slabby
bun install

From npm

npm install -g @russwyte/slabby
# or
bun install -g @russwyte/slabby

Configuration

1. Get your Slab API token

1. Go to your Slab workspace → Settings → API
2. Generate a new API token
3. Copy the token (you'll need it in the next step)

2. Set up environment variables

Create a .env file in the project root:

SLAB_API_TOKEN=your-api-token-here
SLAB_TEAM=your-team-domain  # e.g., "acme" for acme.slab.com

Security Note: Never commit your .env file to git. It's already in .gitignore.

3. Configure Claude Code

Add Slabby to your Claude Code MCP settings:

macOS/Linux: ~/.config/claude-code/claude_desktop_config.json Windows: %APPDATA%\claude-code\claude_desktop_config.json

{
  "mcpServers": {
    "slabby": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/slabby/index.ts"],
      "env": {
        "SLAB_API_TOKEN": "your-token-here",
        "SLAB_TEAM": "your-team-domain"
      }
    }
  }
}

Tip: You can also use environment variables instead of hardcoding the token:

{
  "mcpServers": {
    "slabby": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/slabby/index.ts"],
      "env": {
        "SLAB_API_TOKEN": "${SLAB_API_TOKEN}",
        "SLAB_TEAM": "${SLAB_TEAM}"
      }
    }
  }
}

Usage

Once configured, Claude Code will automatically have access to these tools:

`slab__get_post`

Fetch a Slab post by ID or URL:

Claude, read the Atlas RFC from https://myteam.slab.com/posts/atlas-rfc-xyz123

`slab__update_post`

Update a Slab post:

Claude, update the Atlas RFC to reflect the single goal change

`slab__search`

Search across your Slab workspace:

Claude, search Slab for all documents about "marketing automation"

`slab__list_posts`

List posts in a topic:

Claude, show me all RFCs in the Engineering topic

Development

Run in development mode (with auto-reload):

bun run dev

Run in production mode:

bun run start

Test the MCP server:

# Using the MCP inspector (install separately)
npx @modelcontextprotocol/inspector bun run index.ts

How It Works

Slabby implements the Model Context Protocol, which allows AI assistants like Claude to interact with external tools and services. When you ask Claude Code to read or update Slab content, it:

1. Uses your Slab API token to authenticate (format: Authorization: token YOUR_TOKEN)
2. Makes requests to the Slab GraphQL API at https://api.slab.com/v1/graphql
3. Returns results to Claude Code
4. All edits are attributed to your user account in Slab

Security

• API tokens are stored locally - Never sent to Anthropic's servers
• Edits show as you - All changes attributed to your Slab account
• Read-only by default - Update operations require explicit permission
• Environment-based config - Tokens stored in .env (gitignored)

Slab API Reference

This project uses the Slab GraphQL API. The GraphQL schema is documented at: https://studio.apollographql.com/public/Slab/variant/current/schema/reference

Key operations:

• query GetPost - Fetch post content by ID
• mutation UpdatePost - Update post content
• query SearchPosts - Search posts across workspace
• query ListPosts - List posts, optionally filtered by topic

⚠️ Important: The GraphQL queries in this project are based on common GraphQL patterns and need to be verified against the actual Slab schema before use with production credentials. See SCHEMA_VERIFICATION.md for a detailed verification checklist.

Troubleshooting

"Authentication failed" error

• Check that y