{"id":35711988,"url":"https://github.com/slack-samples/bolt-js-slack-mcp-server","last_synced_at":"2026-01-06T04:52:07.443Z","repository":{"id":330014464,"uuid":"1077905483","full_name":"slack-samples/bolt-js-slack-mcp-server","owner":"slack-samples","description":"A sample app that features an agent that leverages Slack's MCP","archived":false,"fork":false,"pushed_at":"2025-12-22T19:31:08.000Z","size":104,"stargazers_count":3,"open_issues_count":6,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-24T08:54:06.851Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/slack-samples.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-16T23:17:42.000Z","updated_at":"2025-12-22T19:31:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/slack-samples/bolt-js-slack-mcp-server","commit_stats":null,"previous_names":["slack-samples/bolt-js-slack-mcp-server"],"tags_count":null,"template":false,"template_full_name":"slack-samples/bolt-js-assistant-template","purl":"pkg:github/slack-samples/bolt-js-slack-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slack-samples%2Fbolt-js-slack-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slack-samples%2Fbolt-js-slack-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slack-samples%2Fbolt-js-slack-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slack-samples%2Fbolt-js-slack-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slack-samples","download_url":"https://codeload.github.com/slack-samples/bolt-js-slack-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slack-samples%2Fbolt-js-slack-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28221942,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2026-01-06T02:00:07.049Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-06T04:52:05.912Z","updated_at":"2026-01-06T04:52:07.434Z","avatar_url":"https://github.com/slack-samples.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Slack MCP Server AI Agent Template (Bolt for JavaScript)\n\n\u003e ⚠️ **Beta Notice**: This template demonstrates MCP functionality that is currently in beta and not yet widely available to all developers. The functionality shown here is being tested and may change before general availability.\n\n\nThis Bolt for JavaScript template demonstrates how to build [AI Apps](https://docs.slack.dev/ai/) in Slack that leverage the Slack MCP server.\n\nModels from [OpenAI](https://openai.com) are used and can be customized for prompts of all kinds.\n\n## Setup\n\nBefore getting started, make sure you have a development workspace where you have permissions to install apps. If you don’t have one setup, go ahead and [create one](https://slack.com/create).\n\n### Developer Program\n\nJoin the [Slack Developer Program](https://api.slack.com/developer-program) for exclusive access to sandbox environments for building and testing your apps, tooling, and resources created to help you build and grow.\n\n## Installation\n\n### Create a Slack App\n\n1. Open [https://api.slack.com/apps/new](https://api.slack.com/apps/new) and\n   choose \"From an app manifest\"\n2. Choose the workspace you want to install the application to\n3. Copy the contents of [manifest.json](./manifest.json) into the text box that\n   says `*Paste your manifest code here*` (within the JSON tab) and click _Next_\n4. Review the configuration and click _Create_\n\n### Clone the project\n```zsh\n# Clone this project onto your machine\ngit clone https://github.com/slack-samples/bolt-js-slack-mcp-server.git\n```\n\n### Environment Variables\n\nBefore you can run the app, you'll need to store some environment variables.\n\n1. Rename `.env.sample` to `.env`.\n2. Open your apps setting page from [this list](https://api.slack.com/apps), click _Basic Information_ in the left hand menu, then copy the following values into your `.env` file:\n```zsh\nSLACK_CLIENT_ID=YOUR_APP_CLIENT_ID\nSLACK_CLIENT_SECRET=YOUR_APP_CLIENT_SECRET\nSLACK_SIGNING_SECRET=YOUR_APP_SIGNING_SECRET\nSLACK_STATE_SECRET='your-state-secret'\nSLACK_INSTALL_URL='https://\u003cAPP_INSTALLATION_URL\u003e/slack/install'\n```\n\n_Note: the `SLACK_INSTALL_URL` is where users initiate the installation of the app into their workspace. For more information about this URL, please see the [OAuth](#oauth) section._\n\n3. Unlock the OpenAI models from your OpenAI account dashboard by clicking [create a new secret key](https://platform.openai.com/api-keys), then save your OpenAI key into the `.env` file as `OPENAI_API_KEY` like so:\n```zsh\nOPENAI_API_KEY=YOUR_OPEN_API_KEY\n```\n\n\n### Local Project\n\n```zsh\n# Change into the project directory\ncd bolt-js-slack-mcp-server\n\n# Install dependencies\nnpm install\n\n# Run Bolt server\nnpm start\n```\n\n### Linting\n\n```zsh\n# Run lint for code formatting and linting\nnpm run lint\n```\n\n## OAuth\n\nThis sample relies on the usage of user tokens, and therefore requires individual user installations to function as intended.\n\n\u003e **Reminder: the Bolt app must be running _and_ the following endpoints made available for the below URLs to be accessible when updating them in the app configuration.**\n\nWhen using OAuth, Slack requires a public URL where it can send requests. In this template app, we've used [`ngrok`](https://ngrok.com/download). Checkout [this guide](https://ngrok.com/docs#getting-started-expose) for setting it up.\n\nStart `ngrok` to access the app on an external network and create a redirect URL for OAuth.\n\n```\nngrok http 3000\n```\n\nThis output should include a forwarding address for `http` and `https` (we'll use `https`). It should look something like the following:\n\n```\nForwarding   https://3cb89939.ngrok.io -\u003e http://localhost:3000\n```\n\nNavigate to **OAuth \u0026 Permissions** in your app configuration and update the **Redirect URL**. The redirect URL should be set to your `ngrok` forwarding address with the `slack/oauth_redirect` path appended. For example:\n\n```\nhttps://3cb89939.ngrok.io/slack/oauth_redirect\n```\n\nNavigate to **Event Subscriptions** in your app configuration and update the **Request URL**. The request URL should be set to your `ngrok` forwarding address with the `slack/events` path appended. For example:\n\n```\nhttps://3cb89939.ngrok.io/slack/events\n```\n\nThe value set for the `SLACK_INSTALL_URL` in `.env` corresponds to the public URL where users initiate the installation of the app into their workspace. The install URL should be set to your `ngrok` forwarding address with the `slack/install` path appended. For example:\n\n```\nhttps://3cb89939.ngrok.io/slack/install\n```\n\n## Usage\nAfter installing the app into a workspace using the OAuth installtion flow, create a new chat (via DM) with the chatbot. \n\nUpon creation of the new chat, the user is prompted with two static options that demonstrate either sending a message to #general, or creating a new canvas – both as and on behalf of the user.\n\n## Project Structure\n\n### `manifest.json`\n\n`manifest.json` is a configuration for Slack apps. With a manifest, you can create an app with a pre-defined configuration, or adjust the configuration of an existing app.\n\n### `app.js`\n\n`app.js` is the entry point for the application and is the file you'll run to start the server. This project aims to keep this file as thin as possible, primarily using it as a way to route inbound requests.\n\n### `/listeners/assistant`\n\nConfigures the new Slack Assistant features, providing a dedicated side panel UI for users to interact with the AI chatbot. This module includes:\n\n- The `assistant-thread-started.js` file, which responds to new app threads with a list of suggested prompts.\n- The `assistant-thread-context-changed.js` file, which updates the context to include information about where the conversation with the chatbot is occurring (i.e., in a DM or within a channel).\n- The `user-message.js` file, which responds to user messages sent to app threads or from the **Chat** and **History** tab with an LLM generated response.\n\n### `/llm`\n\nThe `openai.js` file handles the OpenAI API initialization and configuration.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslack-samples%2Fbolt-js-slack-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslack-samples%2Fbolt-js-slack-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslack-samples%2Fbolt-js-slack-mcp-server/lists"}