@mcp-monorepo/slack

Slack MCP to access workspace without bot account or app

This package provides a comprehensive set of tools to interact with the Slack API. It allows for fetching channel information, reading message history, searching for channels, and accessing user activity feeds. By leveraging private API endpoints via cookie-based authentication, it offers capabilities beyond the standard public Slack API.

Key Features

• Rich Data Fetching: Access channel content, sidebars, activity feeds, and direct message lists.
• In-Memory Caching: Pre-loads and caches user and channel lists on startup for fast and efficient ID-to-name resolution in subsequent requests.
• Advanced Authentication: Uses xoxd and xoxc tokens to interact with Slack's internal API, enabling a wider range of data access.
• Human-Readable Output: Automatically resolves user and channel IDs in messages to their corresponding names (e.g., <@U123...> becomes John Doe <@U123...>).

Usage

You can run this MCP server directly using npx for local testing:

npx @mcp-monorepo/slack@latest

To integrate this server with a compatible AI model (like Claude), provide the following MCP server configuration:

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-monorepo/slack"
      ],
      "env": {
        "SLACK_WORKSPACE_URL": "<Your SLACK_WORKSPACE_URL Here>",
        "XOXD_TOKEN": "<Your XOXD_TOKEN Here>",
        "XOXC_TOKEN": "<Your XOXC_TOKEN Here>",
        "TENANT_ID": "<Your TENANT_ID Here>"
      }
    }
  }
}

Environment Variables

| Variable | Description | Default | | :--- | :--- | :--- | | SLACK_WORKSPACE_URL | The full base URL of the Slack workspace (e.g., 'https://your-team.slack.com'). | <required> | | XOXD_TOKEN | The Slack authentication 'd' cookie token required for API access. | <required> | | XOXC_TOKEN | The Slack 'xoxc' authentication token required for API access. | <required> | | TENANT_ID | The Slack tenant (workspace) ID, which typically starts with 'T'. | <required> |

Tools

get-dm-list

Get Direct Message List - Returns a list of all direct and group DMs the user can access.

Input Schema

This tool has no defined input schema.

search-channel

Search Slack Channels - Search for Slack channels by multiple keywords in name, topic, or purpose. Each word is a keyword, results are sorted by relevance.

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | search | string | Search query with keywords separated by spaces. Each word is treated as a separate keyword. |

get-channel-info

Get Channel Info - Returns info details for a Slack channel by id.

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | channelId | string | The ID of the Slack channel to get information for |

get-activity-feed

Get Activity Feed - Fetches the latest activity/events from Slack (threads, mentions, reactions, etc).

Input Schema

This tool has no defined input schema.

get-channel-content

Get Channel Content - Returns message history/content for a channel by id, including replies.

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | channelId | string | The ID of the Slack channel to get content from |

get-channel-sidebar

Get Channel Sidebar - Returns a Slack-style list of channels by sidebar section.

Input Schema

This tool has no defined input schema.

Other MCP Servers

This monorepo contains several other MCP server packages available on npm. Each provides a distinct set of tools for use with the Model Context Protocol.

• @mcp-monorepo/confluence: MCP server for Confluence API tools
• @mcp-monorepo/file-browser: MCP server for file system browsing and manipulation (search, ls, tree, grep, open, write, move, mkdir)
• @mcp-monorepo/ics: MCP server for calendar tools using ICS/ical feeds
• @mcp-monorepo/jira: MCP server for Jira tools (JQL, issue management, etc.).
• @mcp-monorepo/location: MCP server for location-based tools using IP address lookup
• @mcp-monorepo/mail: MCP server for mail tools (fetch, read, search, mark as seen).
• @mcp-monorepo/notion-query: MCP server for querying Notion data sources.
• @mcp-monorepo/npm: MCP server for npm command tools (run scripts, install packages, list scripts)
• @mcp-monorepo/weather: Weather MCP tools (geocoding, weather-by-coords) for ModelContextProtocol.

Recent Changes

Version 1.1.3

• fd22b00: Fixed yarn versioning during publish

Version 1.1.2

• Updated dependencies [7929a55]

Version 1.1.1

• 75e8973: migrate monorepo to yarn 4, update CI/husky/scripts and run-on-changed, add yarnrc and packageManager, switch internal deps to workspace:* and simplify bin fields

Authors

• The MCP Monorepo Team

License

This project is licensed under the AGPL-3.0-only License. See the LICENSE file for details.