Skip to content
Back to search

slack

The Slack plugin for Claude Code, updated with each release.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/slackapi--slack-skills-plugin/badge.svg)](/listings/slackapi--slack-skills-plugin)

HTML

<a href="/listings/slackapi--slack-skills-plugin"><img src="/api/listings/slackapi--slack-skills-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

The plugin is published on [Slack's Claude marketplace](https://github.com/slackapi/slack-skills-plugin). Install it from inside Claude Code:

/plugin marketplace add slackapi/slack-skills-plugin
/plugin install slack@slack

The Slack MCP server is configured automatically. You'll be prompted to authenticate to your Slack workspace via OAuth on first use.

Then turn on auto-update:

1. Run `/plugin`. 2. Open **Marketplaces**. 3. Select `slack`. 4. Select **Enable auto-update**.

Without auto-update, update an existing install to the latest version with:

claude plugin marketplace update slack
claude plugin update slack@slack

The plugin is also published on the [official Claude marketplace](https://claude.com/plugins/slack), but its updates are experiencing large delays. We recommend the marketplace above until this is resolved:

/plugin install slack@claude-plugins-official

You can install the plugin from either marketplace, but don't install it from both.

Switching from the official Claude marketplace

If you installed the plugin from the official Claude marketplace, uninstall it first, so that only one copy is enabled:

claude plugin uninstall slack@claude-plugins-official

Then follow the [install steps](#claude-code) above. Run `claude plugin list` to confirm that `slack@slack` is the only Slack plugin listed.

Cursor

The plugin is published on the [official Cursor Marketplace](https://cursor.com/marketplace/slack). Install it from inside Cursor:

/add-plugin slack

This installs the skills, commands, and MCP server together. You'll be prompted to authenticate to your Slack workspace via OAuth on first use.

Codex

The plugin is published as a Codex marketplace in this repository. Add the marketplace, then install the plugin:

codex plugin marketplace add slackapi/slack-skills-plugin
codex plugin add slack@slack

To update an existing install, refresh the marketplace and add the plugin again:

codex plugin marketplace upgrade slack
codex plugin add slack@slack

Start a new Codex session to pick up the plugin, then invoke a skill by name with a `$` mention, for example `$block-kit`.

Codex support currently ships the skills only; the MCP server is not yet wired into the Codex surface.

Other agents

The skills install into other coding agents with [`npx skills`][npx-skills], no plugin marketplace required:

# Install the skills for a coding agent, named by its own identifier
npx skills add slackapi/slack-skills-plugin -y -a <agent>

# For example, Gemini CLI or OpenCode
npx skills add slackapi/slack-skills-plugin -y -a gemini-cli
npx skills add slackapi/slack-skills-plugin -y -a opencode

Other popular agents include `crush`, `devin`, `hermes-agent`, `openclaw`, and `pi`. See [supported agents][npx-skills] for the full list of agents and their identifiers. Add `-g` to install for your user instead of the current project. Run the same command again to update the skills to the latest version.

The `-y` flag installs every skill without prompting. Drop it to choose skills from a list, or pass `-s <skill>` to name the ones you want.

This path carries the skills only: no commands, and no MCP server.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "name": "slack",
  3. "description": "The Slack plugin for Claude Code, updated with each release.",
  4. "owner": {
  5. "name": "Slack"
  6. },
  7. "plugins": [
  8. {
  9. "name": "slack",
  10. "source": {
  11. "source": "url",
  12. "url": "https://github.com/slackapi/slack-skills-plugin.git",
  13. "ref": "v1.8.0"
  14. }
  15. }
  16. ]
  17. }
README.md · README · 174 lines
  1. # Slack MCP and Skills Plugin
  2. A [Claude Code][claude-code], [Cursor][cursor], and [Codex][codex-cli] 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.
  3. [![CI Build](https://github.com/slackapi/slack-skills-plugin/actions/workflows/ci-build.yml/badge.svg)](https://github.com/slackapi/slack-skills-plugin/actions/workflows/ci-build.yml?query=branch%3Amain)
  4. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  5. ## Installation
  6. ### Claude Code
  7. The plugin is published on [Slack's Claude marketplace](https://github.com/slackapi/slack-skills-plugin). Install it from inside Claude Code:
  8. ```text
  9. /plugin marketplace add slackapi/slack-skills-plugin
  10. /plugin install slack@slack
  11. ```
  12. The Slack MCP server is configured automatically. You'll be prompted to authenticate to your Slack workspace via OAuth on first use.
  13. Then turn on auto-update:
  14. 1. Run `/plugin`.
  15. 2. Open **Marketplaces**.
  16. 3. Select `slack`.
  17. 4. Select **Enable auto-update**.
  18. Without auto-update, update an existing install to the latest version with:
  19. ```sh
  20. claude plugin marketplace update slack
  21. claude plugin update slack@slack
  22. ```
  23. The plugin is also published on the [official Claude marketplace](https://claude.com/plugins/slack), but its updates are experiencing large delays. We recommend the marketplace above until this is resolved:
  24. ```text
  25. /plugin install slack@claude-plugins-official
  26. ```
  27. You can install the plugin from either marketplace, but don't install it from both.
  28. #### Switching from the official Claude marketplace
  29. If you installed the plugin from the official Claude marketplace, uninstall it first, so that only one copy is enabled:
  30. ```sh
  31. claude plugin uninstall slack@claude-plugins-official
  32. ```
  33. Then follow the [install steps](#claude-code) above. Run `claude plugin list` to confirm that `slack@slack` is the only Slack plugin listed.
  34. ### Cursor
  35. The plugin is published on the [official Cursor Marketplace](https://cursor.com/marketplace/slack). Install it from inside Cursor:
  36. ```text
  37. /add-plugin slack
  38. ```
  39. This installs the skills, commands, and MCP server together. You'll be prompted to authenticate to your Slack workspace via OAuth on first use.
  40. ### Codex
  41. The plugin is published as a Codex marketplace in this repository. Add the marketplace, then install the plugin:
  42. ```sh
  43. codex plugin marketplace add slackapi/slack-skills-plugin
  44. codex plugin add slack@slack
  45. ```
  46. To update an existing install, refresh the marketplace and add the plugin again:
  47. ```sh
  48. codex plugin marketplace upgrade slack
  49. codex plugin add slack@slack
  50. ```
  51. Start a new Codex session to pick up the plugin, then invoke a skill by name with a `$` mention, for example `$block-kit`.
  52. Codex support currently ships the skills only; the MCP server is not yet wired into the Codex surface.
  53. ### Other agents
  54. The skills install into other coding agents with [`npx skills`][npx-skills], no plugin marketplace required:
  55. ```bash
  56. # Install the skills for a coding agent, named by its own identifier
  57. npx skills add slackapi/slack-skills-plugin -y -a <agent>
  58. # For example, Gemini CLI or OpenCode
  59. npx skills add slackapi/slack-skills-plugin -y -a gemini-cli
  60. npx skills add slackapi/slack-skills-plugin -y -a opencode
  61. ```
  62. Other popular agents include `crush`, `devin`, `hermes-agent`, `openclaw`, and `pi`. See [supported agents][npx-skills] for the full list of agents and their identifiers. Add `-g` to install for your user instead of the current project. Run the same command again to update the skills to the latest version.
  63. The `-y` flag installs every skill without prompting. Drop it to choose skills from a list, or pass `-s <skill>` to name the ones you want.
  64. This path carries the skills only: no commands, and no MCP server.
  65. ## Features
  66. ### MCP Server
  67. The plugin connects your AI tool to Slack's hosted [MCP server][slack-mcp-docs]:
  68. - **Search** - find messages, files, users, and channels (public and private)
  69. - **Messaging** - send, draft, and schedule messages, create channels and DMs, read channels, follow threads, add and read reactions
  70. - **Canvas** - create, read, and update canvas documents
  71. - **Files** - upload files and images and share them in a channel or thread
  72. - **Lists** - create, read, and update lists and their records
  73. - **Users** - read profiles and list channel members
  74. ### Skills
  75. Nine skills load on demand to handle messaging tasks and developer workflows:
  76. - [`slack-messaging`](skills/slack-messaging/SKILL.md) - composing well-formatted, effective Slack messages
  77. - [`slack-search`](skills/slack-search/SKILL.md) - finding messages, files, channels, and people
  78. - [`slack-api`](skills/slack-api/SKILL.md) - discovering and calling Slack Web API methods
  79. - [`slack-docs`](skills/slack-docs/SKILL.md) - finding and reading the right Slack developer docs page
  80. - [`slack-cli`](skills/slack-cli/SKILL.md) - using the [Slack CLI][slack-cli] to create, run, and manage apps
  81. - [`create-slack-app`](skills/create-slack-app/SKILL.md) - building a Slack app or agent with the CLI and [Bolt][bolt]
  82. - [`test-slack-app`](skills/test-slack-app/SKILL.md) - running an app somewhere safe and confirming it works in Slack
  83. - [`deploy-slack-app`](skills/deploy-slack-app/SKILL.md) - deploying a Socket Mode app to Railway or Heroku as a separate, always-on Slack app
  84. - [`block-kit`](skills/block-kit/SKILL.md) - building and validating [Block Kit][block-kit] layouts
  85. ### Commands
  86. Five slash commands for common Slack workflows:
  87. - `/slack:summarize-channel <channel-name>` - Summarize recent activity in a Slack channel
  88. - `/slack:find-discussions <topic>` - Find discussions about a specific topic across Slack channels
  89. - `/slack:draft-announcement <topic>` - Draft a well-formatted Slack announcement and save it as a draft
  90. - `/slack:standup` - Generate a standup update based on your recent Slack activity
  91. - `/slack:channel-digest <channel1, channel2, ...>` - Get a digest of recent activity across multiple Slack channels
  92. ## Usage examples
  93. Once installed, talk to your tool in natural language:
  94. - "Search for messages about the product launch from the last week"
  95. - "Send a message to #general saying the deployment is complete"
  96. - "Summarize the last day of activity in #engineering"
  97. - "Draft an announcement about the new pricing page"
  98. - "Create a new Slack app using Bolt for Python"
  99. - "Build a Block Kit feedback modal with a rating select and a comments field"
  100. - "Validate the Block Kit JSON in ./modal.json"
  101. ## Documentation
  102. - [Slack MCP server][slack-mcp-docs]
  103. - [Slack developer docs](https://docs.slack.dev/)
  104. - [Block Kit Builder][block-kit]
  105. ## Limitations
  106. - **Workspace admin approval.** Your Slack workspace admin must approve MCP integration before you can authenticate.
  107. ## Contributing
  108. We welcome contributions from everyone! Please check out our [contributor's guide](.github/contributing.md) for guidelines on opening issues and pull requests.
  109. Working on the plugin itself? See the [maintainer's guide](.github/maintainers_guide.md) for local development setup.
  110. [claude-code]: https://claude.com/claude-code
  111. [cursor]: https://cursor.com
  112. [codex-cli]: https://developers.openai.com/codex/cli
  113. [slack-mcp-docs]: https://docs.slack.dev/ai/mcp-server/
  114. [npx-skills]: https://github.com/vercel-labs/skills#supported-agents
  115. [slack-cli]: https://tools.slack.dev/slack-cli
  116. [bolt]: https://tools.slack.dev/bolt-js
  117. [block-kit]: https://app.slack.com/block-kit-builder

Version history

  • v1.6.010/31/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.