{"id":47811494,"url":"https://github.com/karbassi/slack-mcp","last_synced_at":"2026-04-03T18:12:52.254Z","repository":{"id":337047676,"uuid":"1152156233","full_name":"karbassi/slack-mcp","owner":"karbassi","description":"MCP server exposing 193 Slack Web API methods as tools for AI agents","archived":false,"fork":false,"pushed_at":"2026-03-22T14:56:10.000Z","size":449,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-22T18:55:36.928Z","etag":null,"topics":["ai-agents","fastmcp","mcp","mcp-server","model-context-protocol","slack","slack-api"],"latest_commit_sha":null,"homepage":"https://github.com/karbassi/slack-mcp#readme","language":"Python","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/karbassi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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":"2026-02-07T12:58:59.000Z","updated_at":"2026-03-22T14:56:13.000Z","dependencies_parsed_at":"2026-02-07T22:01:38.235Z","dependency_job_id":null,"html_url":"https://github.com/karbassi/slack-mcp","commit_stats":null,"previous_names":["karbassi/slack-mcp"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/karbassi/slack-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karbassi%2Fslack-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karbassi%2Fslack-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karbassi%2Fslack-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karbassi%2Fslack-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/karbassi","download_url":"https://codeload.github.com/karbassi/slack-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karbassi%2Fslack-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31368162,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T17:53:18.093Z","status":"ssl_error","status_checked_at":"2026-04-03T17:53:17.617Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ai-agents","fastmcp","mcp","mcp-server","model-context-protocol","slack","slack-api"],"created_at":"2026-04-03T18:12:49.134Z","updated_at":"2026-04-03T18:12:52.246Z","avatar_url":"https://github.com/karbassi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Slack MCP\n\n**Your entire Slack workspace — available to any AI.**\n\n[![Python](https://img.shields.io/pypi/pyversions/slack-mcp?style=flat-square)](https://pypi.org/project/slack-mcp/)\n[![License](https://img.shields.io/github/license/karbassi/slack-mcp?style=flat-square)](LICENSE)\n\nA [Model Context Protocol](https://modelcontextprotocol.io/) server that gives LLMs full access to [Slack](https://slack.com).\u003cbr\u003e\nMessages, channels, files, canvases, lists, search, reactions — all of it.\n\n**220 tools** · **36 API families** · **Every Slack feature**\n\n\u003c/div\u003e\n\n---\n\n## Quick Start\n\n### 1. Create a Slack App\n\n1. Go to [api.slack.com/apps](https://api.slack.com/apps) \u003e **Create New App** \u003e **From a manifest**\n2. Paste the contents of [`manifest.json`](manifest.json)\n3. Install to your workspace\n4. Copy the **User OAuth Token** (`xoxp-...`) from **OAuth \u0026 Permissions**\n\n### 2. Add to your AI client\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClaude Code\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\nclaude mcp add slack -- uvx --from git+https://github.com/karbassi/slack-mcp.git slack-mcp\n```\n\nThen set `SLACK_XOXP_TOKEN` in your shell environment.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClaude Desktop\u003c/strong\u003e\u003c/summary\u003e\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"slack\": {\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"git+https://github.com/karbassi/slack-mcp.git\", \"slack-mcp\"],\n      \"env\": {\n        \"SLACK_XOXP_TOKEN\": \"xoxp-...\"\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCursor\u003c/strong\u003e\u003c/summary\u003e\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"slack\": {\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"git+https://github.com/karbassi/slack-mcp.git\", \"slack-mcp\"],\n      \"env\": {\n        \"SLACK_XOXP_TOKEN\": \"xoxp-...\"\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWindsurf\u003c/strong\u003e\u003c/summary\u003e\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"slack\": {\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"git+https://github.com/karbassi/slack-mcp.git\", \"slack-mcp\"],\n      \"env\": {\n        \"SLACK_XOXP_TOKEN\": \"xoxp-...\"\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eVS Code / GitHub Copilot\u003c/strong\u003e\u003c/summary\u003e\n\nAdd to your VS Code `settings.json`:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"slack\": {\n        \"command\": \"uvx\",\n        \"args\": [\"--from\", \"git+https://github.com/karbassi/slack-mcp.git\", \"slack-mcp\"],\n        \"env\": {\n          \"SLACK_XOXP_TOKEN\": \"xoxp-...\"\n        }\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eLocal clone\u003c/strong\u003e\u003c/summary\u003e\n\n```json\n{\n  \"mcpServers\": {\n    \"slack\": {\n      \"type\": \"stdio\",\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--directory\", \"/path/to/slack-mcp\", \"slack-mcp\"]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n## What Can It Do?\n\n\u003e *\"Catch me up on #engineering from today\"*\n\u003e *\"Reply to Sarah's thread saying we'll ship it Monday\"*\n\u003e *\"Search for anything about the Q3 roadmap\"*\n\u003e *\"Create a channel called #project-atlas and invite the design team\"*\n\n| Domain | Tools | Highlights |\n|---|---|---|\n| **Conversations** | 28 | History, threads, replies, create, archive, invite, mark read |\n| **Undocumented** | 28 | Drafts, saved items, emoji management, granular search, sidebar, threads |\n| **Files** | 16 | Upload, share, edit, list, remote files |\n| **Chat** | 14 | Send, reply, schedule, update, delete, ephemeral |\n| **Users** | 12 | Profile, presence, lookup, list |\n| **Lists** | 12 | Create, edit items, manage access |\n| **Legacy** | 11 | Slash commands, file editing, bot listing |\n| **Team** | 9 | Info, preferences, access logs, billing |\n| **Apps** | 8 | Manifests, connections, authorizations |\n| **Usergroups** | 7 | Create, update, manage members |\n| **Workflows** | 7 | Featured workflows, step completion |\n| **Canvases** | 6 | Create, edit, sections, access control |\n| **Calls** | 6 | Start, end, manage participants |\n| **+ 23 more** | | DND, reminders, bookmarks, reactions, pins, stars, views, search, auth, bots, emoji, ... |\n\nPlus `resolve_names` (bulk ID→name resolution) and `cache_clear` (bust the response cache on demand) utility tools.\n\n### Beyond the Official API\n\n39 undocumented and legacy endpoints — the same internal APIs that Slack's own apps use. Requires session tokens (`xoxc`+`xoxd`).\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eSession endpoints\u003c/strong\u003e — workspace state the official API doesn't expose\u003c/summary\u003e\n\n| Endpoint | What it provides |\n|---|---|\n| `client.boot` | Full workspace bootstrap — channels, users, prefs, feature flags |\n| `client.counts` | Unread counts per channel/DM/thread plus mention counts |\n| `client.userBoot` | User-specific bootstrap data scoped to the authenticated user |\n| `threads.getView` | Thread inbox — the list of threads with read/unread state |\n| `subscriptions.thread.mark` | Mark individual threads as read or unread |\n| `drafts.list` | List all unsent message drafts |\n| `drafts.create` | Create a message draft with Block Kit text |\n| `drafts.update` | Edit an existing draft |\n| `drafts.delete` | Delete a draft |\n| `saved.list` | List saved-for-later items |\n| `saved.add` | Save a message for later with optional due date |\n| `saved.delete` | Remove a saved-for-later item |\n| `emoji.add` | Add a custom emoji from a URL |\n| `emoji.remove` | Remove a custom emoji |\n| `emoji.adminList` | Emoji with rich metadata — uploader, date, usage stats |\n| `search.modules.messages` | Granular message search |\n| `search.modules.files` | File-specific search |\n| `search.modules.channels` | Server-side channel search by name or topic |\n| `search.modules.people` | Fuzzy people search by name, title, department |\n| `search.modules.dms` | Search within DMs only |\n| `conversations.view` | Channel view with read state and personal config |\n| `conversations.listPrefs` | Per-channel notification and mute preferences |\n| `users.channelSections.list` | Sidebar organization — custom sections, favorites |\n| `users.priority.list` | Contacts ranked by interaction frequency |\n| `experiments.getByUser` | A/B test experiment assignments |\n| `api.features` | Workspace feature flags |\n| `aiApps.list` | AI applications configured in the workspace |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eLegacy endpoints\u003c/strong\u003e — functionality missing from the official API\u003c/summary\u003e\n\n| Endpoint | What it provides |\n|---|---|\n| `chat.command` | Execute slash commands programmatically |\n| `commands.list` | List all slash commands including custom ones |\n| `files.edit` | Edit a file's title, content, or filetype in-place |\n| `files.share` | Share a file to a channel |\n| `bots.list` | List all bot users in the workspace |\n| `team.prefs.get` | Team-level preferences — retention, permissions, domains |\n| `users.prefs.get` | All user preferences — notifications, sidebar, theme |\n| `users.prefs.set` | Set any individual user preference |\n| `users.admin.invite` | Invite users by email (Enterprise Grid) |\n| `users.admin.setInactive` | Deactivate a user account (Enterprise Grid) |\n| `channels.delete` | Dead method — included for completeness |\n\n\u003e [!WARNING]\n\u003e Undocumented endpoints can break without notice. They use session tokens (`xoxc`+`xoxd`) which expire and must be re-grabbed from browser cookies.\n\n\u003c/details\u003e\n\n## Authentication\n\n| Variable | Required | Description |\n|---|---|---|\n| `SLACK_XOXP_TOKEN` | **Yes** | User OAuth token from your Slack app |\n| `SLACK_XOXC_TOKEN` | No | Browser session token for undocumented endpoints |\n| `SLACK_XOXD_TOKEN` | No | Browser session cookie (paired with `xoxc`) |\n\n\u003e [!TIP]\n\u003e The `xoxp` token covers all Slack Web API tools. Utility tools like `resolve_names` and `cache_clear` work without additional auth. For undocumented endpoints (unread counts, workspace boot, file editing), you also need `xoxc`+`xoxd` — grab them from your browser cookies while logged into slack.com.\n\n## Caching\n\nResponses are cached automatically to reduce API calls:\n\n- **Stable data** (users, teams, bots, emoji) — 1 hour TTL\n- **Dynamic data** (channel lists, members, bookmarks) — 5 minute TTL\n- **Old threads** (`conversations_replies` with ts \u003e 1 hour old) — 1 hour TTL\n- **Bounded history** (`conversations_history` with old date range) — 1 hour TTL\n- **Resolved names** (user/bot → 1 hour, channel → 5 minutes)\n\nCache is stored at the platform-native location (`~/Library/Caches/slack-mcp` on macOS, `~/.cache/slack-mcp` on Linux). Set `XDG_CACHE_HOME` to override.\n\nUse the `cache_clear` tool to bust the cache when you need fresh data.\n\n### Name Resolution\n\nAll tool responses automatically resolve user, channel, DM, and bot IDs to display names via a `_resolved_names` field — no extra tool calls needed. Resolved names are disk-cached to avoid redundant API lookups.\n\n## Development\n\n```bash\ngit clone https://github.com/karbassi/slack-mcp.git\ncd slack-mcp\nuv sync\nuv run ruff check .\nuv run pytest tests/\nuv run pytest tests/ -m integration  # requires tokens in .env\n```\n\n\u003e [!NOTE]\n\u003e ~68 integration tests are skipped because they require a bot token (`xoxb`), Slack Connect, interactive triggers (e.g. `views.open`), or would be destructive (e.g. `auth.revoke`). Adding bot token support is a future goal.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarbassi%2Fslack-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkarbassi%2Fslack-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarbassi%2Fslack-mcp/lists"}