Slack MCP Server
Lets agents search Slack messages, files, channels and users, read channels and threads, post and schedule messages, and edit canvases and lists.
Claude Code, server and Slack skills together
(run inside a Claude Code session)
/plugin install slack@claude-plugins-official
The plugin’s repository recommends Slack’s own marketplace instead, because updates on the official marketplace are delayed. Install from one marketplace, not both:
/plugin marketplace add slackapi/slack-skills-plugin
/plugin install slack@slack
Claude Code, server only
(from your terminal, then run /mcp in Claude Code to finish signing in)
$ claude mcp add --transport http --scope local slack https://mcp.slack.com/mcp
Claude Code, manual
(.mcp.json in the project root, or ~/.claude.json for all projects; restart Claude Code, then run /mcp)
{
"mcpServers": {
"slack": {
"type": "http",
"url": "https://mcp.slack.com/mcp",
"oauth": {
"clientId": "YOUR_SLACK_APP_CLIENT_ID",
"callbackPort": 3118
}
}
}
}
The plugin itself ships this block with Slack’s own client ID, 1601185624273.8899143856786.
Claude Desktop and claude.ai
(Customize > Connectors > +, find Slack, add it and complete the OAuth flow)
Cursor, server and skills together
(in a Cursor Agent chat, or search “slack” in the Cursor plugin marketplace)
/add-plugin slack
Cursor, server only
(Cursor Settings > MCP; save, then click Connect)
{
"mcpServers": {
"slack": {
"url": "https://mcp.slack.com/mcp",
"auth": {
"CLIENT_ID": "3660753192626.8903469228982"
}
}
}
}
Codex
(Slack’s harness guide; you need your Slack app’s client ID and an approved integration)
$ codex mcp add --transport http slack https://mcp.slack.com/mcp
Or in ~/.codex/config.toml, then run codex mcp login slack and check with codex mcp list:
[mcp_servers.slack]
url = "https://mcp.slack.com/mcp"
auth = "oauth"
The Slack plugin for Codex installs only the skills; its README says the MCP server is not yet wired into the Codex surface (slack-skills-plugin).
Commands and configuration as Slack gives them on docs.slack.dev, Connect to Claude, Connect to Cursor and the harness guide. Each client asks you to sign in to Slack with OAuth on first use.
The Slack MCP server is Slack’s hosted endpoint for agents to search, read and post in your workspace over OAuth.
The Slack MCP server URL is https://mcp.slack.com/mcp. Slack runs it, speaks JSON-RPC 2.0 over Streamable HTTP, and does not support SSE connections or Dynamic Client Registration (Slack MCP server overview).
Every request is tied to a registered Slack app, and only apps published in the Slack Marketplace or internal apps may use it; unlisted apps are refused. Your workspace admin approves the integration through Slack’s normal app approval process, so a setup that looks right can still fail until that approval is in place (overview). Slack’s developer home suggests a free Developer Program sandbox if you have no approval yet (docs.slack.dev).
Slack names four partner clients that work without building your own app: Claude.ai, Claude Code, Perplexity and Cursor. It also documents setup for Codex and Pi, where you supply your own Slack app’s client ID (Connecting to agent harnesses).
What it can do, and the scope each tool needs
The tools act as the signed-in user, with a user token. The scopes and rate-limit tiers below are from Slack’s overview page; the same limits apply whether an action runs through MCP or the Web API.
| Tool | User token scopes | Rate limit |
|---|---|---|
| Search messages and channels | search:read.public, search:read.private, search:read.mpim, search:read.im | Special (see method docs) |
| Search files | search:read.files | Special (see method docs) |
| Search users | search:read.users | Tier 2: 20+ per minute |
| Read a channel or thread | channels:history, groups:history, mpim:history, im:history | Tier 3: 50+ per minute |
| Send or schedule a message | chat:write | Send: special; schedule: Tier 3 |
| Create a conversation or channel | channels:write, groups:write, im:write, mpim:write (by type) | Tier 2: 20+ per minute |
| Add or get reactions | reactions:write / reactions:read | Tier 3: 50+ per minute |
| Create, update or read a canvas | canvases:read, canvases:write | Tier 2 to Tier 4 |
| User profile and email | users:read, users:read.email | Tier 4: 100+ per minute |
| List channel members | channels:read, groups:read, mpim:read | Tier 4: 100+ per minute |
| List your channels | channels:read, groups:read, im:read, mpim:read | Tier 2: 20+ per minute |
| Upload or read files | files:write / files:read | Tier 4: 100+ per minute |
| Lists | lists:read, lists:write | Tier 2 / Tier 3 |
| Search emoji | emoji:read | Tier 2: 20+ per minute |
If the server connects but a tool is missing, Slack’s troubleshooting points first at the user token lacking that tool’s scope, then at an admin restriction on MCP access (harness guide).
Because the server can post messages, create channels and edit canvases as you, Slack asks you to think before running it alongside other MCP servers in the same client, and points admins to the audit logs for MCP activity. If your app has an IP allowlist, MCP requests from addresses outside it are rejected (overview).
The old Slack reference server
Many setup posts still show the slack server from the Model Context Protocol project’s reference servers. That server now sits in modelcontextprotocol/servers-archived, whose README says it is no longer maintained and carries no security guarantees. Slack’s hosted server is the one Slack documents and supports.
Questions
What is the Slack MCP server URL?
https://mcp.slack.com/mcp, over Streamable HTTP. Slack does not accept SSE connections to it.Is there an official Slack MCP server?
slack reference server from the MCP project is archived and unmaintained.Why does the OAuth sign-in fail or the connection stay inactive?
Does the Slack plugin connect Codex to the MCP server?
codex mcp add as Slack’s harness guide shows.Sources
- Slack developer docs: Slack MCP server overview
- Slack developer docs: Connect to Claude
- Slack developer docs: Connect to Cursor
- Slack developer docs: Connecting the Slack MCP server to agent harnesses
- Slack developer docs: Slack MCP and Skills Plugin
- slackapi/slack-skills-plugin on GitHub
- modelcontextprotocol/servers-archived on GitHub
Checked November 12, 2026.
Productivity
View all- Atlassian Rovo MCP ServerConnects agents to Jira, Confluence, Jira Service Management, Bitbucket, Compass and Loom so they can search, create and update work items and pages.Official
- Linear MCPLets agents find, create and update Linear issues, projects and comments.Official
- Notion MCPLets agents search, read and edit pages and databases in a Notion workspace.Official
