Slack Model Context Protocol Server

This is a connector to allow Claude Desktop (or any MCP client) to interact with your Slack workspace to post messages and query a list of all users.

Local Development

In order to run this client locally, add the following configuration to your Claude Desktop MCP Server config file:

 {
  "mcpServers": {
    "mcp-slack-local": {
      "command": "node",
      "args": ["/path/to/project/dist/index.js"], <---- replace this with your project path
      "env": {
        "SLACK_BOT_USER_OAUTH_TOKEN": "test-bot-token", 
        "SLACK_TEAM_ID": "test-team-id"
      }
    },
  }
}

After this, you should be able to test this implementation in your Claude Desktop App using example prompts like:

"Can you list all users of my Slack team?"
"Can you send a welcome message to my Slack Channel with the ID <channel id>?"

Running the server locally:

node dist/index.js

With the build in another terminal

npm run watch

Slack Permission Scopes

The following permissions are already implemented:

| Permission | Description | Implemented | |------------|-------------|-------------| | app_configurations:read | Read app configuration info via App Manifest APIs | ❌ | | app_configurations:write | Write app configuration info and create apps via App Manifest APIs | ❌ | | app_mentions:read | View messages that directly mention @your_slack_app in conversations that the app is in | ❌ | | assistant:write | Allow your slack app to act as an AI Assistant | ❌ | | bookmarks:read | List bookmarks | ❌ | | bookmarks:write | Create, edit, and remove bookmarks | ❌ | | calls:read | View information about ongoing and past calls | ❌ | | calls:write | Start and manage calls in a workspace | ❌ | | canvases:read | your slack app will be able to access contents of canvases created inside Slack. | ❌ | | canvases:write | your slack app will be able to create, edit and remove canvases. | ❌ | | channels:history | View messages and other content in public channels that your slack app has been added to | ❌ | | channels:join | Join public channels in a workspace | ❌ | | channels:manage | Manage public channels that your slack app has been added to and create new ones | ❌ | | channels:read | View basic information about public channels in a workspace | ❌ | | channels:write.invites | Invite members to public channels | ❌ | | channels:write.topic | Set the description of public channels | ❌ | | chat:write | Post messages in approved channels & conversations | ✅ | | chat:write.customize | Send messages as @your_slack_app with a customized username and avatar | ❌ | | chat:write.public | Send messages to channels @your_slack_app isn't a member of | ❌ | | commands | Add shortcuts and/or slash commands that people can use | ❌ | | conversations.connect:manage | Allows your slack app to manage Slack Connect channels | ❌ | | conversations.connect:read | Receive Slack Connect invite events sent to the channels your slack app is in | ❌ | | conversations.connect:write | Create Slack Connect invitations for channels that your slack app has been added to, and accept invitations sent to your slack app | ❌ | | datastore:read | View and see data from Slack App Datastore | ❌ | | datastore:write | Write data to Slack App Datastore | ❌ | | dnd:read | View Do Not Disturb settings for people in a workspace | ❌ | | emoji:read | View custom emoji in a workspace | ❌ | | files:read | View files shared in channels and conversations that your slack app has been added to | ❌ | | files:write | Upload, edit, and delete files as your slack app | ❌ | | groups:history | View messages and other content in private channels that your slack app has been added to | ❌ | | groups:read | View basic information about private channels that your slack app has been added to | ❌ | | groups:write | Manage private channels that your slack app has been added to and create new ones | ❌ | | groups:write.invites | Invite members to private channels | ❌ | | groups:write.topic | Set the description of private channels | ❌ | | im:history | View messages and other content in direct messages that your slack app has been added to | ❌ | | im:read | View basic information about direct messages that your slack app has been added to | ❌ | | im:write | Start direct messages with people | ❌ | | im:write.topic | Set the description in direct messages | ❌ | | incoming-webhook | Create one-way webhooks to post messages to a specific channel | ❌ | | links.embed:write | Embed video player URLs in messages and app surfaces | ❌ | | links:read | View URLs in messages | ❌ | | links:write | Show previews of URLs in messages | ❌ | | metadata.message:read | Allows your slack app to read message metadata in channels that your slack app has been added to | ❌ | | mpim:history | View messages and other content in group direct messages that your slack app has been added to | ❌ | | mpim:read | View basic information about group direct messages that your slack app has been added to | ❌ | | mpim:write | Start group direct messages with people | ❌ | | mpim:write.topic | Set the description in group direct messages | ❌ | | none | Execute methods without needing a scope | ❌ | | pins:read | View pinned content in channels and conversations that your slack app has been added to | ❌ | | pins:write | Add and remove pinned messages and files | ❌ | | reactions:read | View emoji reactions and their associated content in channels and conversations that your slack app has been added to | ❌ | | reactions:write | Add and edit emoji reactions | ❌ | | reminders:read | View reminders created by your slack app | ❌ | | reminders:write | Add, remove, or mark reminders as complete | ❌ | | remote_files:read | View remote files added by the app in a workspace | ❌ | | remote_files:share | Share remote files on a user's behalf | ❌ | | remote_files:write | Add, edit, and delete remote files on a user's behalf | ❌ | | search:read.files | Search a workspace's content in files | ❌ | | search:read.im | Search a workspace's content in direct messages | ❌ | | search:read.mpim | Search a workspace's content in group direct messages | ❌ | | search:read.private | Search a workspace's content in private channels | ❌ | | search:read.public | Search a workspace's content in public channels | ❌ | | team.billing:read | Allows your slack app to read the billing plan for workspaces your slack app has been installed to | ❌ | | team.preferences:read | Allows your slack app to read the preferences for workspaces your slack app has been installed to | ❌ | | team:read | View the name, email domain, and icon for workspaces your slack app is connected to | ❌ | | tokens.basic | Execute methods without needing a scope | ❌ | | triggers:read | Read new Platform triggers | ❌ | | triggers:write | Create new Platform triggers | ❌ | | usergroups:read | View user groups in a workspace | ❌ | | usergroups:write | Create and manage user groups | ❌ | | users.profile:read | View profile details about people in a workspace | ❌ | | users:read | View people in a workspace | ✅ | | users:read.email | View email addresses of people in a workspace | ❌ | | users:write | Set presence for your slack app | ❌ | | workflow.steps:execute | Add steps that people can use in Workflow Builder | ❌ | | workflows.templates:read | Read a workflow template | ❌ | | workflows.templates:write | Write a workflow template | ❌ |

Contact

If you have questions, feel free to contact us via AVIMBU.