Sloppybee MCP Server

An MCP (Model Context Protocol) server that enables Claude Desktop and other MCP-compatible clients to create and manage shareable task lists using the Sloppybee API.

Features

• create_list - Create shareable task lists with optional AI-generated tasks
• get_list - Retrieve existing lists by slug
• generate_tasks - Generate task suggestions without creating a list

Installation

Prerequisites

1. Node.js 18 or higher
2. A Sloppybee API key (Get one here)

Install from npm

npm install -g @sloppybee/mcp-server

Or install from source

git clone https://github.com/sloppybee/mcp-server
cd mcp-server
npm install
npm run build

Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS/Linux

{
  "mcpServers": {
    "sloppybee": {
      "command": "npx",
      "args": ["@sloppybee/mcp-server"],
      "env": {
        "SLOPPYBEE_API_KEY": "sb_live_your_api_key_here"
      }
    }
  }
}

Windows

On Windows, use npx.cmd instead of npx:

{
  "mcpServers": {
    "sloppybee": {
      "command": "npx.cmd",
      "args": ["@sloppybee/mcp-server"],
      "env": {
        "SLOPPYBEE_API_KEY": "sb_live_your_api_key_here"
      }
    }
  }
}

Global Installation (Alternative)

If installed globally with npm install -g @sloppybee/mcp-server:

macOS/Linux:

{
  "mcpServers": {
    "sloppybee": {
      "command": "sloppybee-mcp",
      "env": {
        "SLOPPYBEE_API_KEY": "sb_live_your_api_key_here"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "sloppybee": {
      "command": "sloppybee-mcp.cmd",
      "env": {
        "SLOPPYBEE_API_KEY": "sb_live_your_api_key_here"
      }
    }
  }
}

Other MCP Clients

The server uses stdio transport and expects the SLOPPYBEE_API_KEY environment variable to be set.

Usage

Once configured, you can ask Claude to create task lists:

"Create a packing list for a week-long beach vacation"

"Make a shopping list for Thanksgiving dinner for 12 people"

"Generate task suggestions for planning a birthday party"

Available Tools

create_list

Create a new shareable task list.

Parameters:

• title (required): Title of the list
• tasks: Array of tasks with task and optional comment
• ai_generate: Set to true for AI-generated tasks
• ai_prompt: Prompt for AI generation (required if ai_generate is true)
• expires_in_days: Days until expiration (default: 7, max: 30)

Example:

{
  "title": "Beach Vacation Packing",
  "ai_generate": true,
  "ai_prompt": "Essential items for a week at the beach"
}

get_list

Retrieve an existing list.

Parameters:

• slug (required): The list slug from the URL
• password: Password if list is protected

generate_tasks

Generate task suggestions without creating a list.

Parameters:

• prompt (required): Description of tasks to generate
• existing_tasks: Tasks to avoid duplicating
• count: Number of tasks (default: 10, max: 50)

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run production build
npm start

Rate Limits

• Free tier: 100 requests/hour
• Contact [email protected] for higher limits

Links

• Sloppybee
• API Documentation
• Get API Key

License

MIT