OfficialProductivityremote HTTP

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.

Install

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?
Yes. Slack hosts it at mcp.slack.com and documents it on docs.slack.dev. The older slack reference server from the MCP project is archived and unmaintained.
Why does the OAuth sign-in fail or the connection stay inactive?
Slack lists three causes: the workspace admin has not approved the MCP integration, the client ID is wrong, or the Slack app is unlisted (only Marketplace and internal apps may use MCP).
Does the Slack plugin connect Codex to the MCP server?
No. In Codex the plugin adds the Slack skills only. To reach the server from Codex, add it with codex mcp add as Slack’s harness guide shows.

Sources

Checked November 12, 2026.

Productivity

View all
Aftergradient

What are you looking for?

Search commands, errors, tools