Connect your AI Agents to Slack in minutes
Available tools
list_channels
List all channels in the workspace
create_channel
Create a new channel
get_channel_info
Get information about a channel using Channel ID (not channel name)
join_channel
Join a channel
leave_channel
Leave a channel
archive_channel
Archive a channel
unarchive_channel
Unarchive a channel
get_channel_members
Get members of a channel
invite_to_channel
Invite users to a channel
kick_from_channel
Remove a user from a channel
set_channel_topic
Set the topic for a channel
set_channel_purpose
Set the purpose for a channel
How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's Slack MCP server
FAQs on using Merge's Slack MCP server
How can I use the Slack MCP server?
The Slack MCP server allows AI agents to search channels and files, send and read messages, fetch user profiles, and much more.
To use Slack with Merge Agent Handler, you'd use Agent Handler’s standard flow:
- Add Slack to a Tool Pack: Create or configure a Tool Pack and add the Slack connector with the specific tools you want to enable (e.g., list_channels, post_message)
- Set up authentication: Choose between individual authentication (user-specific Slack credentials) and shared authentication (organization-level access)
- Register users: Create registered users in Agent Handler who’ll interact with Slack through your agent
- Authenticate via Merge Link: When a user first attempts a Slack tool call, Agent Handler automatically prompts them through a guided authentication flow using Merge Link
- Make tool calls: Once you've authenticated your agent, it can execute Slack tool calls with built-in security, observability, and DLP safeguards
What are popular tools for Slack’s MCP server?
Search tools
- Search messages and files: Filter by date, user, and type; retrieve metadata and content
- Search users: Filter by name, partial name, email, or ID; retrieve user details and status
- Search private and public channels: Filter by name/description; retrieve channel metadata
Messaging tools
- Send messages: Send to any Slack conversation
- Read channels: Retrieve full message history
- Read threads: Retrieve entire threaded conversations
User management
- Fetch user profiles: Retrieve full profile metadata, including custom fields
What makes Merge Agent Handler’s Slack MCP server better than alternative Slack MCP servers?
Secure authentication & credential handling
Merge Agent Handler provides built-in authentication flows, user onboarding, and dynamic authorization handling so Slack credentials are managed securely and consistently.
Granular security with data loss prevention (DLP)
The Security Gateway actively scans Slack tool inputs and outputs for sensitive information and can block, redact, or mask data. This protects against data misuse across Slack interactions.
Real-time observability with fully-searchable logs
Agent Handler logs every tool call and underlying Slack API request. These server Logs are fully searchable, allowing you to easily debug, audit, and optimize your agentic workflows with Slack.
Connector Studio for customization
Merge Agent Handler’s Slack MCP server already includes 50+ tools. But you can modify existing ones and add any with ease.
How does Merge Agent Handler manage authentication?
Merge handles all Slack credential workflows—including onboarding prompts, dynamic authorization flows, and individual vs. shared authentication configuration—through Merge Agent Handler and built-in auth logic.
For each connector in a Tool Pack, you can determine whether Slack requires individual authentication or can use shared authentication.
Can I set custom security rules for Slack tool calls?
Yes. Agent Handler supports:
- Default DLP rules
- Custom rules that scan Slack tool inputs and responses for sensitive data
- Actions, including block, redact, or mask
For example, you can set rules that block post_message calls that contain credit card numbers before they're sent to Slack channels; redact social security numbers from search_messages responses; and log any get_user_profile calls that access employee phone numbers.
What are common use cases for the Slack MCP server?
- Knowledge retrieval: An AI agent can search Slack message history, threads, and channels to answer questions, surface past decisions, and provide context
- Automated notifications and updates: Agents can post status updates, such as daily summaries, to specific channels based on data from connected systems (e.g., issues in Jira)
- Workflow orchestration: Agents can coordinate cross-platform actions, like creating an Asana ticket from a Slack conversation and then posting the ticket link back to the thread
- Meeting and event coordination: Agents can parse Slack discussions to identify scheduling needs, check availability across calendar systems, and send meeting confirmations to relevant channels or users
- Customer support triage: Agents can monitor support channels, categorize requests, and route issues to the appropriate team members
Explore other MCP servers built and managed by Merge
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
