Getting Started ⚡️ Bolt for Python

Slack app example from 📚 Getting started with Bolt for Python

Overview

This is a Slack app built with the Bolt for Python framework that showcases responding to events and interactive buttons.

Claude Code, Codex, Cursor, and Other Coding Agents

Install the Slack MCP and Skills Plugin so your coding agent can create, run, and deploy Slack apps, look up Web API methods and scopes, and build Block Kit without guessing.

Claude Code

Run this in a Claude Code session:

/plugin install slack@claude-plugins-official

Codex

Run this in your terminal:

codex plugin marketplace add slackapi/slack-skills-plugin
codex plugin add slack@slack

Cursor

Run this in a Cursor Agent chat:

/add-plugin slack

Other agents

Install the skills with npx skills, using your agent's identifier:

npx skills add slackapi/slack-skills-plugin -y -a <agent>

# For example, OpenCode
npx skills add slackapi/slack-skills-plugin -y -a opencode

Running locally

1. Setup environment variables

# Replace with your tokens
export SLACK_BOT_TOKEN=<your-bot-token>
export SLACK_APP_TOKEN=<your-app-level-token>

2. Setup your local project

# Clone this project onto your machine
git clone https://github.com/slack-samples/bolt-python-getting-started-app.git

# Change into this project
cd bolt-python-getting-started-app/

# Setup virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install the dependencies
pip install -e .

3. Start servers

python3 app.py

More examples

Looking for more examples of Bolt for Python? Browse to bolt-python/examples/ for a long list of usage, server, and deployment code samples!

Contributing

Issues and questions

Found a bug or have a question about this project? We'd love to hear from you!

1. Browse to slackapi/bolt-python/issues
2. Create a new issue
3. Mention that you're using this example app

See you there and thanks for helping to improve Bolt for everyone!