From 84c72e14b730efeda0e92f0561abc6e5bec5107f Mon Sep 17 00:00:00 2001 From: Michael Brooks Date: Thu, 25 Jun 2026 16:07:46 -0700 Subject: [PATCH 1/5] docs: rewrite README for external users Refocuses the README on Claude Code and Cursor end users instead of plugin maintainers. Title becomes "Slack MCP and Skills Plugin", install section leads, Features lists the MCP server tools, the six skills, and the five slash commands, and maintainer setup moves to .github/contributing.md and .github/maintainers_guide.md. --- README.md | 137 ++++++++++++++++++++++++------------------------------ 1 file changed, 62 insertions(+), 75 deletions(-) diff --git a/README.md b/README.md index 7c4992a..e9defdc 100644 --- a/README.md +++ b/README.md @@ -1,108 +1,95 @@ -# Slack Plugin +# Slack MCP and Skills Plugin -This repository contains the configuration needed to integrate Slack with Cursor IDE and Claude Code. The plugin enables your agents to interact directly with your Slack workspace, allowing you to search messages, send communications, manage canvases, and more—all through natural language. +A plugin for [Claude Code][claude-code] and [Cursor][cursor] that brings Slack into your AI assistant - through the [Slack MCP server][slack-mcp-docs] for direct workspace actions and a curated set of Slack skills for both users and developers. -## Features +[![CI Build](https://github.com/slackapi/slack-mcp-plugin/actions/workflows/ci-build.yml/badge.svg)](https://github.com/slackapi/slack-mcp-plugin/actions/workflows/ci-build.yml) +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) -The Slack MCP server provides the following capabilities: +## Installation -- **Search**: Find messages, files, users, and channels (both public and private) -- **Messaging**: Send messages, retrieve channel histories, and access threaded conversations -- **Canvas**: Create and share formatted documents, export content as markdown -- **User Management**: Retrieve user profiles including custom fields and status information +### Claude Code -## Prerequisites +The plugin is published on the [official Claude marketplace](https://claude.com/plugins/slack). Install it from inside Claude Code: -Before setting up the Slack MCP server, ensure you have: +``` +/plugin install slack@claude-plugins-official +``` -- Cursor IDE or Claude Code CLI installed -- Access to a Slack workspace with MCP integration approved by your workspace admin +The Slack MCP server is configured automatically. You'll be prompted to authenticate to your Slack workspace via OAuth on first use. -## Installation +### Cursor -Choose the installation method for your IDE: +Click the button below to add the Slack MCP server to Cursor: -### Claude Code +[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=slack&config=eyJ1cmwiOiJodHRwczovL21jcC5zbGFjay5jb20vbWNwIiwiYXV0aCI6eyJDTElFTlRfSUQiOiIzNjYwNzUzMTkyNjI2Ljg5MDM0NjkyMjg5ODIifX0%3D) -If you're using Claude Code CLI, you can install this as a plugin by cloning it locally: +After install, Cursor surfaces a connect button - use it to authenticate to your Slack workspace. -```bash -git clone https://github.com/slackapi/slack-mcp-plugin.git -cd slack-mcp-plugin -claude --plugin-dir ./ -``` +## Features -The Slack MCP server will be automatically configured when the plugin loads. You will be prompted to authenticate into your Slack workspace via OAuth. - -The Claude plugin uses the following MCP configuration (`.mcp.json`): - -```json -{ - "mcpServers": { - "slack": { - "type": "http", - "url": "https://mcp.slack.com/mcp", - "oauth": { - "clientId": "1601185624273.8899143856786", - "callbackPort": 3118 - } - } - } -} -``` +### MCP Server -### Cursor +The plugin connects your AI assistant to Slack's hosted [MCP server][slack-mcp-docs]: -You can use the following Add to Cursor button or follow the steps below to manually configure the Slack MCP server in Cursor: +- **Search** - find messages, files, users, and channels (public and private) +- **Messaging** - send and schedule messages, read channels, follow threads, add reactions +- **Canvas** - create, read, and update canvas documents +- **Users** - read profiles and list channel members -[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=slack&config=eyJ1cmwiOiJodHRwczovL21jcC5zbGFjay5jb20vbWNwIiwiYXV0aCI6eyJDTElFTlRfSUQiOiIzNjYwNzUzMTkyNjI2Ljg5MDM0NjkyMjg5ODIifX0%3D) +### Skills -#### Step 1: Open Cursor Settings +Six skills load on demand to handle messaging tasks and developer workflows: -Navigate to **Cursor → Settings → Cursor Settings** (or use the keyboard shortcut `Cmd+,` on macOS, `Ctrl+,` on Windows/Linux). +- [`slack:slack-messaging`](skills/slack-messaging/SKILL.md) - composing well-formatted, effective Slack messages +- [`slack:slack-search`](skills/slack-search/SKILL.md) - finding messages, files, channels, and people +- [`slack:slack-api`](skills/slack-api/SKILL.md) - discovering and calling Slack Web API methods +- [`slack:slack-cli`](skills/slack-cli/SKILL.md) - using the [Slack CLI][slack-cli] to create, run, and manage apps +- [`slack:create-slack-app`](skills/create-slack-app/SKILL.md) - building a Slack app or agent with the CLI and [Bolt][bolt] +- [`slack:block-kit`](skills/block-kit/SKILL.md) - building and validating [Block Kit][block-kit] layouts -#### Step 2: Navigate to MCP Tab +### Commands -In the Settings interface, click on the **MCP** tab to access MCP server configurations. +Five slash commands for common Slack workflows: -#### Step 3: Add Slack MCP Configuration +- `/slack:summarize-channel ` - Summarize recent activity in a Slack channel +- `/slack:find-discussions ` - Find discussions about a specific topic across Slack channels +- `/slack:draft-announcement ` - Draft a well-formatted Slack announcement and save it as a draft +- `/slack:standup` - Generate a standup update based on your recent Slack activity +- `/slack:channel-digest ` - Get a digest of recent activity across multiple Slack channels -Add the following configuration to connect to the remote Slack MCP server: +## Usage examples -```json -{ - "mcpServers": { - "slack": { - "url": "https://mcp.slack.com/mcp", - "auth": { - "CLIENT_ID": "3660753192626.8903469228982" - } - } - } -} -``` +Once installed, talk to your assistant in natural language: -Save the configuration. You will also see a connect button once added. Click that to authenticate into your Slack Workspace. +- "Search for messages about the product launch from the last week" +- "Send a message to #general saying the deployment is complete" +- "Summarize the last day of activity in #engineering" +- "Draft an announcement about the new pricing page" +- "Create a new Slack app using Bolt for Python" +- "Build a Block Kit feedback modal with a rating select and a comments field" +- "Validate the Block Kit JSON in ./modal.json" -## Usage Examples +## Documentation -Once configured, you can interact with Slack through your AI assistant using natural language: +- [Slack MCP server][slack-mcp-docs] +- [Slack developer docs](https://docs.slack.dev/) +- [Block Kit Builder][block-kit] -- **Search messages**: "Search for messages about the product launch in the last week" -- **Send messages**: "Send a message to #general channel saying the deployment is complete" -- **Find users**: "Who is the user with email john@example.com?" -- **Access threads**: "Show me the conversation thread from that message" -- **Create canvases**: "Create a canvas document with our meeting notes" +## Limitations -## Documentation & Resources +- **Workspace admin approval.** Your Slack workspace admin must approve MCP integration before you can authenticate. -- [Official Slack MCP Server Documentation](https://docs.slack.dev/ai/mcp-server/) +## Issues -## Notes & Limitations +Found a bug or have an idea? Open an [issue](https://github.com/slackapi/slack-mcp-plugin/issues) or [pull request](https://github.com/slackapi/slack-mcp-plugin/pulls). -- **Remote server only**: This configuration connects to Slack's hosted MCP server. No local installation is required or supported. -- **Admin approval required**: Your Slack workspace administrator must approve MCP integration before you can use this feature. +## Contributing -## Questions or Issues? +Contributions are welcome - see [`.github/contributing.md`](.github/contributing.md). Maintainers should also read [`.github/maintainers_guide.md`](.github/maintainers_guide.md). -For questions about the Slack MCP server or integration issues, please refer to the [official Slack documentation](https://docs.slack.dev/ai/mcp-server/) or contact your workspace administrator. +[claude-code]: https://claude.com/claude-code +[cursor]: https://cursor.com +[slack-mcp-docs]: https://docs.slack.dev/ai/mcp-server/ +[slack-cli]: https://tools.slack.dev/slack-cli +[bolt]: https://tools.slack.dev/bolt-js +[block-kit]: https://app.slack.com/block-kit-builder From 3159f6a323f3fde649fd8bba173f8bddcb160643 Mon Sep 17 00:00:00 2001 From: Michael Brooks Date: Thu, 25 Jun 2026 16:22:28 -0700 Subject: [PATCH 2/5] docs: replace Issues section with Contributing pointer Mirrors the slackapi/slack-cli README: a single Contributing section that links to .github/contributing.md (covers issues and PRs) and to .github/maintainers_guide.md for local development. --- README.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index e9defdc..66de64c 100644 --- a/README.md +++ b/README.md @@ -79,13 +79,11 @@ Once installed, talk to your assistant in natural language: - **Workspace admin approval.** Your Slack workspace admin must approve MCP integration before you can authenticate. -## Issues - -Found a bug or have an idea? Open an [issue](https://github.com/slackapi/slack-mcp-plugin/issues) or [pull request](https://github.com/slackapi/slack-mcp-plugin/pulls). - ## Contributing -Contributions are welcome - see [`.github/contributing.md`](.github/contributing.md). Maintainers should also read [`.github/maintainers_guide.md`](.github/maintainers_guide.md). +We welcome contributions from everyone! Please check out our [contributor's guide](.github/contributing.md) for guidelines on opening issues and pull requests. + +Working on the plugin itself? See the [maintainer's guide](.github/maintainers_guide.md) for local development setup. [claude-code]: https://claude.com/claude-code [cursor]: https://cursor.com From c1bf7f3d8cb3568d1604ef24620dfb6d34dd171e Mon Sep 17 00:00:00 2001 From: Michael Brooks Date: Mon, 29 Jun 2026 09:38:56 -0700 Subject: [PATCH 3/5] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 66de64c..cc4375b 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Slack MCP and Skills Plugin -A plugin for [Claude Code][claude-code] and [Cursor][cursor] that brings Slack into your AI assistant - through the [Slack MCP server][slack-mcp-docs] for direct workspace actions and a curated set of Slack skills for both users and developers. +A [Claude Code][claude-code] and [Cursor][cursor] plugin that brings Slack into your AI tools with a [Slack MCP Server][slack-mcp-docs] and set of Slack skills for both users and developers. [![CI Build](https://github.com/slackapi/slack-mcp-plugin/actions/workflows/ci-build.yml/badge.svg)](https://github.com/slackapi/slack-mcp-plugin/actions/workflows/ci-build.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) From 97edd6f4037d35d3a2a7a7d2a1ab48d20c0502c4 Mon Sep 17 00:00:00 2001 From: Michael Brooks Date: Mon, 29 Jun 2026 11:19:04 -0700 Subject: [PATCH 4/5] Update README.md Co-authored-by: William Bergamin --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index cc4375b..da2c806 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ After install, Cursor surfaces a connect button - use it to authenticate to your ### MCP Server -The plugin connects your AI assistant to Slack's hosted [MCP server][slack-mcp-docs]: +The plugin connects your AI tool to Slack's hosted [MCP server][slack-mcp-docs]: - **Search** - find messages, files, users, and channels (public and private) - **Messaging** - send and schedule messages, read channels, follow threads, add reactions From dd60fb79efa3f86e1c506c653be9d73f3b6bc11a Mon Sep 17 00:00:00 2001 From: William Bergamin Date: Mon, 29 Jun 2026 11:49:01 -0700 Subject: [PATCH 5/5] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index da2c806..c3126d5 100644 --- a/README.md +++ b/README.md @@ -59,7 +59,7 @@ Five slash commands for common Slack workflows: ## Usage examples -Once installed, talk to your assistant in natural language: +Once installed, talk to your tool in natural language: - "Search for messages about the product launch from the last week" - "Send a message to #general saying the deployment is complete"