Connect your AI Agents to Slack in minutes

Merge lets you securely connect your agents to Slack and thousands of tools instantly

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}
11
Copy Code

Open 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}
Copy Code
Copied!

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  }
Copy Code

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}
Copy Code

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

airtable
Airtable
asana
Asana
calendly
Calendly
confluence
Confluence
figma
Figma
github
GitHub
gmail
Gmail
gong
Gong
google_calendar
Google Calendar
google_drive
Google Drive
greenhouse
Greenhouse
hubspot
HubSpot
intercom
Intercom
jira
Jira
jira_service_management
Jira Service Management
linear
Linear
microsoft_teams
Microsoft Teams
notion
Notion
onedrive
OneDrive
outlook
Outlook
pipedrive
Pipedrive
quickbooks_online
QuickBooks Online
sapsf
SAP SuccessFactors
salesforce
Salesforce
servicenow
ServiceNow
sharepoint
SharePoint
shopify
Shopify
stripe
Stripe
weather
Weather
wikipedia
Wikipedia
zendesk
Zendesk
zoom
Zoom

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