https://github.com/slackapi/slack-mcp-plugin
Repo containing the configuration information for the Slack MCP to be added to other clients
https://github.com/slackapi/slack-mcp-plugin
Last synced: 26 days ago
JSON representation
Repo containing the configuration information for the Slack MCP to be added to other clients
- Host: GitHub
- URL: https://github.com/slackapi/slack-mcp-plugin
- Owner: slackapi
- License: mit
- Created: 2026-02-12T23:46:51.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-02-16T23:55:25.000Z (27 days ago)
- Last Synced: 2026-02-17T05:45:12.823Z (27 days ago)
- Homepage:
- Size: 9.77 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/contributing.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Slack MCP Server
This repository contains the configuration needed to integrate the Slack Model Context Protocol (MCP) server with Cursor IDE and Claude Code. The MCP 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.
## Features
The Slack MCP server provides the following capabilities:
- **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
## Prerequisites
Before setting up the Slack MCP server, ensure you have:
- Cursor IDE or Claude Code CLI installed
- Access to a Slack workspace with MCP integration approved by your workspace admin
## Installation
Choose the installation method for your IDE:
### Claude Code
If you're using Claude Code CLI, you can install this as a plugin:
```bash
claude mcp add-from-claude-plugin /path/to/slack-mcp-cursor-plugin
```
Or clone the repo and install locally:
```bash
git clone https://github.com/slackapi/slack-mcp-cursor-plugin.git
cd slack-mcp-cursor-plugin
claude mcp add-from-claude-plugin .
```
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
}
}
}
}
```
### Cursor
Follow these steps to manually configure the Slack MCP server in Cursor:
#### Step 1: Open Cursor Settings
Navigate to **Cursor → Settings → Cursor Settings** (or use the keyboard shortcut `Cmd+,` on macOS, `Ctrl+,` on Windows/Linux).
#### Step 2: Navigate to MCP Tab
In the Settings interface, click on the **MCP** tab to access MCP server configurations.
#### Step 3: Add Slack MCP Configuration
Add the following configuration to connect to the remote Slack MCP server:
```json
{
"mcpServers": {
"slack": {
"url": "https://mcp.slack.com/mcp",
"auth": {
"CLIENT_ID": "3660753192626.8903469228982"
}
}
}
}
```
Save the configuration. You will also see a connect button once added. Click that to authenticate into your Slack Workspace.
## Usage Examples
Once configured, you can interact with Slack through your AI assistant using natural language:
- **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"
## Documentation & Resources
- [Official Slack MCP Server Documentation](https://docs.slack.dev/ai/mcp-server/)
## Notes & Limitations
- **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.
## Questions or Issues?
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.