feat: add Slack MCP Server support as HTTP Server by mwbrooks · Pull Request #47 · slack-samples/bolt-python-support-agent

mwbrooks · 2026-04-01T23:06:34Z

Type of change

New feature
Bug fix
Documentation

Summary

This pull request adds Slack MCP Server support. The MCP Server currently support User Tokens, so it requires OAuth and a HTTP Server. The goal is to allow Casey to run as a Socket Mode server without the Slack MCP Server or as a HTTP Server with Slack MCP Server support.

Add app_oauth.py as an alternative to app.py that starts an HTTP server instead of using Socket Mode.
Shared manifest.json for Socket Mode and HTTP configured for ngrok.
Update README.md files with setup instructions.
Update App Home to display whether Slack MCP Server is disconnected/connected.
Update App Home with a "Connect to Slack MCP Server" link.
Tweak system prompt to use the Slack MCP Tools to get info.

Reviewers

Follow the README.md → HTTP OAuth section for setup
Test the Password reset use-case
- with the Slack MCP, it should find your email address automatically
- without the Slack MCP, it should ask for your email address

Requirements

I have ensured the changes I am contributing align with existing patterns and have tested and linted my code
I've read and agree to the Code of Conduct

Add app_oauth.py as an alternative to app.py that starts an HTTP server instead of using Socket Mode. Include manifest_oauth.json with request URLs configured for ngrok and update READMEs with setup instructions.

Add a toggle button to the App Home that tracks account connection state using an in-memory store. This is a placeholder for the real OAuth flow.

This reverts commit 9fe578d.

Replace the deep-link authorize URL with the standard /slack/install path for the App Home connect link. Remove the MCP server try/except fallback from run_casey() to avoid silently dropping all MCP tools on connection errors. Clean up unused AuthorizeUrlGenerator.

mwbrooks · 2026-04-06T19:10:53Z

+# oauth data
+data/


question: Is data/ the standard directory name? Or, should we use something more specific?

mwbrooks · 2026-04-06T19:11:31Z

+USER_SCOPES = [
+    "search:read",
+    "channels:history",
+    "channels:read",
+    "groups:history",
+    "groups:read",
+    "im:history",
+    "mpim:history",
+    "users:read",
+]


note: These scopes should match what's in the manifest file

…eset

…ents-sdk Port all pydantic-ai branch changes to the other two implementations: - Add Slack MCP Server integration with OAuth user token - Replace button-based App Home UI with text-based MCP status - Use AsyncOAuthSettings for claude-agent-sdk's AsyncApp - Add MCP setup steps to README OAuth sections - Expand user scopes for MCP capabilities - Update system prompt with Slack MCP Server section - Simplify app_home_opened to use context.user_token

RunContextWrapper.context IS the CaseyDeps instance directly — unlike Pydantic AI's RunContext which has a .deps property. The incorrect .deps access raised AttributeError silently caught by the SDK.

Prevents accidentally committing App IDs from maintainer environments. This top-level gitignore is not part of the app templates.

Update the agent system prompt and tool descriptions so the agent tries to look up the user's email from their Slack profile before triggering a password reset, falling back to asking the user if the lookup fails.

…le file Merge both manifests into a single manifest.json per directory. The superset manifest includes user scopes and placeholder URLs using ngrok-free.app, which validates against Slack's schema. For HTTP/OAuth mode, developers just set socket_mode_enabled to false and replace ngrok-free.app with their ngrok domain.

WilliamBergamin

Very nice work on this 💯 🚀

WilliamBergamin · 2026-04-08T13:49:18Z

+                redirect_uri = os.environ.get("SLACK_REDIRECT_URI", "")
+                install_url = urljoin(redirect_uri, "/slack/install")


Nice 💯 I like this better then what I did before

WilliamBergamin · 2026-04-08T13:53:13Z

@@ -0,0 +1,89 @@
+import json


When working on the project I was wondering if we could actually move this logic at the top of app_oauth.py that way everything is in one file 🤔

I would love to do that! When I originally tried, it caused a circular dependency with app_home_opened.py. But maybe our new approach removed those dependencies entirely 👀 I'll make a note to look.

Great suggestion @WilliamBergamin! I've been able to combine app_oauth.py and oauth.py now, which is much better!

Commit 13a37ea

WilliamBergamin · 2026-04-08T13:53:34Z

 [tool.ruff.format]

 [tool.pytest.ini_options]
+asyncio_mode = "auto"


Not sure we need this since the sample uses sync python 🤔

Good call @WilliamBergamin!

Since we use the @pytest.mark.asyncio decorators on the async tests, we can use asyncio_mode = "strict" and because strict is the default, we can remove it entirely. The auto allows async tests to skip the decorator and automatically run as an async test. But generally I prefer the explicit use of the decorator and it's one less configuration setting.

Commit 9fb82fe

feat: add HTTP server entry point for OAuth support

bbe2866

Add app_oauth.py as an alternative to app.py that starts an HTTP server instead of using Socket Mode. Include manifest_oauth.json with request URLs configured for ngrok and update READMEs with setup instructions.

mwbrooks assigned mwbrooks and WilliamBergamin Apr 1, 2026

mwbrooks added the enhancement New feature or request label Apr 1, 2026

mwbrooks and others added 9 commits April 1, 2026 16:22

feat: add Connect/Disconnect button to App Home

d0e7a52

Add a toggle button to the App Home that tracks account connection state using an in-memory store. This is a placeholder for the real OAuth flow.

docs: add OAuth install step to README setup instructions

79efc88

feat: add Slack MCP Server support when user token is available

479c406

Make it work

9fe578d

Revert "Make it work"

cbaed00

This reverts commit 9fe578d.

feat: replace the connect/disconnect buttons with status text

657d88e

feat: fallback on bot token when oauth creds are missing

abc940f

chore: remove unused connect_account action handler

1a5d616

mwbrooks commented Apr 6, 2026

View reviewed changes

Comment thread pydantic-ai/listeners/events/app_mentioned.py Outdated

mwbrooks commented Apr 6, 2026

View reviewed changes

Comment thread pydantic-ai/agent/casey.py Outdated

mwbrooks commented Apr 6, 2026

View reviewed changes

mwbrooks added 13 commits April 6, 2026 13:18

refactor: merge Slack MCP prompt into main system prompt

1a64be3

chore: remove install URL print on server startup

0bf9caa

docs: add MCP toggle step to OAuth setup instructions

6f6dde1

chore: move SLACK_SIGNING_SECRET under OAuth credentials in .env.sample

37962fd

chore: standardize ngrok placeholder to YOUR_NGROK_SUBDOMAIN

6f73709

docs: improve readability of OAuth env setup step in README

35e44fb

fix: remove divider before @casey context block in App Home

5b59b59

feat: instruct Casey to look up email via Slack MCP before password r…

1d4aa94

…eset

chore: use context.user_token instead of manual query

3704b8f

bug: fix displaying the email address for password resets

9db55bb

bug: fix context access in openai-agents-sdk emoji and resolve tools

c64ac1c

RunContextWrapper.context IS the CaseyDeps instance directly — unlike Pydantic AI's RunContext which has a .deps property. The incorrect .deps access raised AttributeError silently caught by the SDK.

chore: ignore .slack/apps.json files in monorepo gitignore

a93888a

Prevents accidentally committing App IDs from maintainer environments. This top-level gitignore is not part of the app templates.

mwbrooks added 2 commits April 7, 2026 11:02

bug: read OAuth user scopes from manifest.json instead of hardcoding

5ec69b3

fix: add pytest asyncio_mode and fix ruff formatting

71a44cc

mwbrooks marked this pull request as ready for review April 7, 2026 18:44

mwbrooks requested a review from WilliamBergamin April 7, 2026 18:44

mwbrooks added 3 commits April 7, 2026 11:47

Merge branch 'main' into slack-mcp-server

f3bc921

fix: improve password reset prompt to look up email from Slack profile

413fc75

Update the agent system prompt and tool descriptions so the agent tries to look up the user's email from their Slack profile before triggering a password reset, falling back to asking the user if the lookup fails.

mwbrooks merged commit 0008a5d into main Apr 7, 2026
7 checks passed

mwbrooks deleted the slack-mcp-server branch April 7, 2026 22:40

WilliamBergamin reviewed Apr 8, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: add Slack MCP Server support as HTTP Server#47

feat: add Slack MCP Server support as HTTP Server#47
mwbrooks merged 28 commits intomainfrom
slack-mcp-server

mwbrooks commented Apr 1, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

mwbrooks Apr 6, 2026

Uh oh!

mwbrooks Apr 6, 2026

Uh oh!

Uh oh!

WilliamBergamin left a comment

Uh oh!

WilliamBergamin Apr 8, 2026

Uh oh!

WilliamBergamin Apr 8, 2026

Uh oh!

mwbrooks Apr 8, 2026

Uh oh!

mwbrooks Apr 8, 2026

Uh oh!

WilliamBergamin Apr 8, 2026

Uh oh!

mwbrooks Apr 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		redirect_uri = os.environ.get("SLACK_REDIRECT_URI", "")
		install_url = urljoin(redirect_uri, "/slack/install")

Conversation

mwbrooks commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Type of change

Summary

Reviewers

Requirements

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

WilliamBergamin left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

mwbrooks commented Apr 1, 2026 •

edited

Loading