Slack Lists MCP Server

A Model Context Protocol (MCP) server that gives AI assistants full read and write access to Slack Lists.

This server acts as a bridge between AI models and Slack, enabling seamless creation, retrieval, updating, deletion, filtering, and management of Slack List items through a standardized protocol. It empowers AI assistants like Claude Desktop to become powerful productivity tools for managing tasks, projects, and data within Slack.

This project provides a complete package with:

• Comprehensive Toolset: Create, query, update, delete, filter, and export list items.
• Robust Implementation: Built with Python, FastMCP, and best practices.
• Easy Deployment: Simple setup with environment variables.
• Detailed Documentation: Full README, tool reference, and examples.
• Extensible Design: Easily add new tools and functionality.

The write paths have been verified against a live Slack workspace (see Verification status).

Features

This MCP server provides a rich set of tools for interacting with Slack Lists:

• Create Single Item: Add one item to a list with detailed fields.
• Bulk Create Items: Add multiple items at once with built-in rate limiting to respect Slack's API.
• Retrieve Items: Fetch a list of items with optional metadata.
• Update Items: Update any cell on an existing item — check a task off, reassign it, reschedule it, or edit any field (full task management).
• Delete Items: Permanently remove an item from a list.
• Discover Columns: Infer a list's column IDs, types, and select option IDs from its existing items (Slack exposes no schema API, so this saves you from hunting for IDs in browser dev tools).
• Filter Items: Powerful server-side filtering based on any field value (status, assignee, priority, etc.).
• Export Data: Export list items to JSON or CSV format for analysis or backup.
• Subtask Creation: Create sub-items under a parent item.
• Full Field Support: Works with all Slack List field types (text, date, user, select, checkbox, number, email, phone).
• Error Handling: Robust error handling and clear feedback for failed operations.

Getting Started

Follow these steps to get your Slack Lists MCP server up and running.

Prerequisites

• Python 3.10+
• Slack Workspace: A Slack workspace where you have permission to install apps.
• Slack Bot Token: A bot token with lists:read and lists:write scopes.

1. Create a Slack App

1. Go to the Slack API website and click Create New App.
2. Choose "From scratch", give your app a name (e.g., "Lists MCP Server"), and select your workspace.
3. In the app settings, go to OAuth & Permissions.
4. Under Bot Token Scopes, add the following scopes:
   • lists:read
   • lists:write
5. Click Install to Workspace at the top of the page and authorize the app.
6. Copy the Bot User OAuth Token (it starts with xoxb-). This is your SLACK_BOT_TOKEN.

2. Installation

Clone the repository and install the dependencies:

# Clone the repository
git clone https://github.com/justadityaraj/slack-lists-mcp.git
cd slack-lists-mcp

# Create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

3. Configuration

Create a .env file by copying the example:

cp .env.example .env

Open the .env file and set your SLACK_BOT_TOKEN:

SLACK_BOT_TOKEN=xoxb-your-bot-token-here

The server lo

... View full README on GitHub