MCP 服务器

Slabby

An MCP server that enables AI agents to read, search, update, and list documentation within a Slab knowledge base. It facilitates keeping technical docs and team wikis in sync with development workflows through direct Slab integration.

README

🧱 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

Go to your Slab workspace → Settings → API
Generate a new API token
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:

Uses your Slab API token to authenticate (format: Authorization: token YOUR_TOKEN)
Makes requests to the Slab GraphQL API at https://api.slab.com/v1/graphql
Returns results to Claude Code
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:

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

License

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.