🧱 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 your SLAB_API_TOKEN is correct
• Verify the token has appropriate permissions in Slab settings

"Team not found" error

• Ensure SLAB_TEAM matches your Slab subdomain (e.g., "acme" for acme.slab.com)

Claude Code doesn't see the tools

• Restart Claude Code after updating MCP config
• Check that the absolute path to index.ts is correct
• Verify bun is in your PATH

Contributing

Contributions welcome! Please feel free to submit issues, fork the repository, and send pull requests.

When contributing, please:

1. Add tests for any new functionality
2. Ensure all tests pass with bun test
3. Follow the existing code style
4. Update documentation as needed

License

Copyright 2025 Russ White

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this project except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

See the LICENSE file for the full license text.

Related Projects

• Model Context Protocol - MCP specification
• Claude Code - AI-powered development environment
• Slab API - Official Slab API documentation

---

Built with ❤️ using Bun and the MCP SDK