From 71b1098555d5207e7fadd56164adfbf784f7e1d5 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:09:24 -0800 Subject: [PATCH 01/29] feat: add slackbot.skills.create method example Co-Authored-By: Claude --- methods/README.md | 4 +++ methods/src/slackbot/__init__.py | 0 methods/src/slackbot/skills/.slack/.gitignore | 2 ++ .../src/slackbot/skills/.slack/config.json | 6 ++++ methods/src/slackbot/skills/.slack/hooks.json | 5 ++++ methods/src/slackbot/skills/__init__.py | 0 methods/src/slackbot/skills/manifest.json | 22 +++++++++++++++ .../slackbot/skills/slackbot_skills_create.py | 28 +++++++++++++++++++ 8 files changed, 67 insertions(+) create mode 100644 methods/src/slackbot/__init__.py create mode 100644 methods/src/slackbot/skills/.slack/.gitignore create mode 100644 methods/src/slackbot/skills/.slack/config.json create mode 100644 methods/src/slackbot/skills/.slack/hooks.json create mode 100644 methods/src/slackbot/skills/__init__.py create mode 100644 methods/src/slackbot/skills/manifest.json create mode 100644 methods/src/slackbot/skills/slackbot_skills_create.py diff --git a/methods/README.md b/methods/README.md index 847080a..6cd1949 100644 --- a/methods/README.md +++ b/methods/README.md @@ -42,3 +42,7 @@ $ slack run chat_post_message.py # Make the request ### chat - **[chat.postMessage](https://docs.slack.dev/reference/methods/chat.postmessage)**: Sends a message to a channel. [Implementation](./src/chat/chat_post_message.py). + +### slackbot + +- **[slackbot.skills.create](https://docs.slack.dev/reference/methods/slackbot.skills.create)**: Creates a skill from markdown instructions, or turns an existing canvas the caller owns into a skill. [Implementation](./src/slackbot/skills/slackbot_skills_create.py). diff --git a/methods/src/slackbot/__init__.py b/methods/src/slackbot/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/methods/src/slackbot/skills/.slack/.gitignore b/methods/src/slackbot/skills/.slack/.gitignore new file mode 100644 index 0000000..973ba60 --- /dev/null +++ b/methods/src/slackbot/skills/.slack/.gitignore @@ -0,0 +1,2 @@ +apps.dev.json +cache/ diff --git a/methods/src/slackbot/skills/.slack/config.json b/methods/src/slackbot/skills/.slack/config.json new file mode 100644 index 0000000..909afbe --- /dev/null +++ b/methods/src/slackbot/skills/.slack/config.json @@ -0,0 +1,6 @@ +{ + "manifest": { + "source": "local" + }, + "project_id": "00000000-0000-0000-0000-000000000000" +} diff --git a/methods/src/slackbot/skills/.slack/hooks.json b/methods/src/slackbot/skills/.slack/hooks.json new file mode 100644 index 0000000..ce474c9 --- /dev/null +++ b/methods/src/slackbot/skills/.slack/hooks.json @@ -0,0 +1,5 @@ +{ + "hooks": { + "get-hooks": "python3 -m slack_cli_hooks.hooks.get_hooks" + } +} diff --git a/methods/src/slackbot/skills/__init__.py b/methods/src/slackbot/skills/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/methods/src/slackbot/skills/manifest.json b/methods/src/slackbot/skills/manifest.json new file mode 100644 index 0000000..217886f --- /dev/null +++ b/methods/src/slackbot/skills/manifest.json @@ -0,0 +1,22 @@ +{ + "display_information": { + "name": "Slack API Methods", + "description": "Example implementations to call \"slackbot.skills\" methods" + }, + "features": { + "bot_user": { + "display_name": "Slack API Methods", + "always_online": true + } + }, + "oauth_config": { + "scopes": { + "bot": ["skills:write"] + } + }, + "settings": { + "org_deploy_enabled": true, + "socket_mode_enabled": true, + "token_rotation_enabled": false + } +} diff --git a/methods/src/slackbot/skills/slackbot_skills_create.py b/methods/src/slackbot/skills/slackbot_skills_create.py new file mode 100644 index 0000000..b363acf --- /dev/null +++ b/methods/src/slackbot/skills/slackbot_skills_create.py @@ -0,0 +1,28 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the slackbot.skills.create method +response = client.slackbot_skills_create( + display_name="Daily priorities", + category="productivity", + description="Reviews information from Slack and your calendar to suggest priorities for the day.", + example_prompt="Run {skill} for today", + instructions="# Purpose\nSuggest the three most important things to work on today.", + mcp_servers=[ + { + "app_id": "A0123ABCD", + "server_id": "Amcp0456EFGH", + "service_type": "app", + }, + ], +) + +# Inspect the response +print(response) From fe8f375d81f801cdc9a5a3f2eb2089258f761445 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:11:35 -0800 Subject: [PATCH 02/29] feat: add slackbot.skills.info method example Co-Authored-By: Claude --- methods/README.md | 1 + methods/src/slackbot/skills/manifest.json | 2 +- .../src/slackbot/skills/slackbot_skills_info.py | 17 +++++++++++++++++ 3 files changed, 19 insertions(+), 1 deletion(-) create mode 100644 methods/src/slackbot/skills/slackbot_skills_info.py diff --git a/methods/README.md b/methods/README.md index 6cd1949..aa9da54 100644 --- a/methods/README.md +++ b/methods/README.md @@ -46,3 +46,4 @@ $ slack run chat_post_message.py # Make the request ### slackbot - **[slackbot.skills.create](https://docs.slack.dev/reference/methods/slackbot.skills.create)**: Creates a skill from markdown instructions, or turns an existing canvas the caller owns into a skill. [Implementation](./src/slackbot/skills/slackbot_skills_create.py). +- **[slackbot.skills.info](https://docs.slack.dev/reference/methods/slackbot.skills.info)**: Returns one Slackbot skill, including its instructions. [Implementation](./src/slackbot/skills/slackbot_skills_info.py). diff --git a/methods/src/slackbot/skills/manifest.json b/methods/src/slackbot/skills/manifest.json index 217886f..fc89fdb 100644 --- a/methods/src/slackbot/skills/manifest.json +++ b/methods/src/slackbot/skills/manifest.json @@ -11,7 +11,7 @@ }, "oauth_config": { "scopes": { - "bot": ["skills:write"] + "bot": ["skills:read", "skills:write"] } }, "settings": { diff --git a/methods/src/slackbot/skills/slackbot_skills_info.py b/methods/src/slackbot/skills/slackbot_skills_info.py new file mode 100644 index 0000000..1bb43f1 --- /dev/null +++ b/methods/src/slackbot/skills/slackbot_skills_info.py @@ -0,0 +1,17 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the slackbot.skills.info method +response = client.slackbot_skills_info( + skill_id="F0123ABCD", +) + +# Inspect the response +print(response) From 24c54e95e1b68617e3c29ebe16d16b6625407ea5 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:11:47 -0800 Subject: [PATCH 03/29] feat: add slackbot.skills.update method example Co-Authored-By: Claude --- methods/README.md | 1 + .../slackbot/skills/slackbot_skills_update.py | 29 +++++++++++++++++++ 2 files changed, 30 insertions(+) create mode 100644 methods/src/slackbot/skills/slackbot_skills_update.py diff --git a/methods/README.md b/methods/README.md index aa9da54..cc93018 100644 --- a/methods/README.md +++ b/methods/README.md @@ -47,3 +47,4 @@ $ slack run chat_post_message.py # Make the request - **[slackbot.skills.create](https://docs.slack.dev/reference/methods/slackbot.skills.create)**: Creates a skill from markdown instructions, or turns an existing canvas the caller owns into a skill. [Implementation](./src/slackbot/skills/slackbot_skills_create.py). - **[slackbot.skills.info](https://docs.slack.dev/reference/methods/slackbot.skills.info)**: Returns one Slackbot skill, including its instructions. [Implementation](./src/slackbot/skills/slackbot_skills_info.py). +- **[slackbot.skills.update](https://docs.slack.dev/reference/methods/slackbot.skills.update)**: Changes a Slackbot skill's instructions or metadata. Only the inputs you send are changed; a call that changes nothing succeeds without writing. [Implementation](./src/slackbot/skills/slackbot_skills_update.py). diff --git a/methods/src/slackbot/skills/slackbot_skills_update.py b/methods/src/slackbot/skills/slackbot_skills_update.py new file mode 100644 index 0000000..8afe249 --- /dev/null +++ b/methods/src/slackbot/skills/slackbot_skills_update.py @@ -0,0 +1,29 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the slackbot.skills.update method +response = client.slackbot_skills_update( + skill_id="F0123ABCD", + category="productivity", + description="Reviews information from Slack and your calendar to suggest priorities for the day.", + display_name="Daily priorities", + example_prompt="Run {skill} for today", + instructions="# Purpose\nSuggest the three most important things to work on today.", + mcp_servers=[ + { + "app_id": "A0123ABCD", + "server_id": "Amcp0456EFGH", + "service_type": "app", + }, + ], +) + +# Inspect the response +print(response) From 2aca0c7b985f0abcba920438f27378d4f8684dc8 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:11:59 -0800 Subject: [PATCH 04/29] feat: add slackbot.skills.list method example Co-Authored-By: Claude --- methods/README.md | 1 + .../slackbot/skills/slackbot_skills_list.py | 19 +++++++++++++++++++ 2 files changed, 20 insertions(+) create mode 100644 methods/src/slackbot/skills/slackbot_skills_list.py diff --git a/methods/README.md b/methods/README.md index cc93018..b3f9add 100644 --- a/methods/README.md +++ b/methods/README.md @@ -47,4 +47,5 @@ $ slack run chat_post_message.py # Make the request - **[slackbot.skills.create](https://docs.slack.dev/reference/methods/slackbot.skills.create)**: Creates a skill from markdown instructions, or turns an existing canvas the caller owns into a skill. [Implementation](./src/slackbot/skills/slackbot_skills_create.py). - **[slackbot.skills.info](https://docs.slack.dev/reference/methods/slackbot.skills.info)**: Returns one Slackbot skill, including its instructions. [Implementation](./src/slackbot/skills/slackbot_skills_info.py). +- **[slackbot.skills.list](https://docs.slack.dev/reference/methods/slackbot.skills.list)**: Lists Slackbot skills from the caller's point of view. Instructions are not included. [Implementation](./src/slackbot/skills/slackbot_skills_list.py). - **[slackbot.skills.update](https://docs.slack.dev/reference/methods/slackbot.skills.update)**: Changes a Slackbot skill's instructions or metadata. Only the inputs you send are changed; a call that changes nothing succeeds without writing. [Implementation](./src/slackbot/skills/slackbot_skills_update.py). diff --git a/methods/src/slackbot/skills/slackbot_skills_list.py b/methods/src/slackbot/skills/slackbot_skills_list.py new file mode 100644 index 0000000..2aa970a --- /dev/null +++ b/methods/src/slackbot/skills/slackbot_skills_list.py @@ -0,0 +1,19 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the slackbot.skills.list method +response = client.slackbot_skills_list( + category="productivity", + filter="library", + limit=100, +) + +# Inspect the response +print(response) From 4c3deb5ca5e2c3c12b38b3370ea6f34fb91717dc Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:12:13 -0800 Subject: [PATCH 05/29] feat: add slackbot.skills.library.add method example Co-Authored-By: Claude --- methods/README.md | 1 + .../slackbot/skills/library/.slack/.gitignore | 2 ++ .../skills/library/.slack/config.json | 6 +++++ .../slackbot/skills/library/.slack/hooks.json | 5 +++++ .../src/slackbot/skills/library/__init__.py | 0 .../src/slackbot/skills/library/manifest.json | 22 +++++++++++++++++++ .../library/slackbot_skills_library_add.py | 17 ++++++++++++++ 7 files changed, 53 insertions(+) create mode 100644 methods/src/slackbot/skills/library/.slack/.gitignore create mode 100644 methods/src/slackbot/skills/library/.slack/config.json create mode 100644 methods/src/slackbot/skills/library/.slack/hooks.json create mode 100644 methods/src/slackbot/skills/library/__init__.py create mode 100644 methods/src/slackbot/skills/library/manifest.json create mode 100644 methods/src/slackbot/skills/library/slackbot_skills_library_add.py diff --git a/methods/README.md b/methods/README.md index b3f9add..b150161 100644 --- a/methods/README.md +++ b/methods/README.md @@ -47,5 +47,6 @@ $ slack run chat_post_message.py # Make the request - **[slackbot.skills.create](https://docs.slack.dev/reference/methods/slackbot.skills.create)**: Creates a skill from markdown instructions, or turns an existing canvas the caller owns into a skill. [Implementation](./src/slackbot/skills/slackbot_skills_create.py). - **[slackbot.skills.info](https://docs.slack.dev/reference/methods/slackbot.skills.info)**: Returns one Slackbot skill, including its instructions. [Implementation](./src/slackbot/skills/slackbot_skills_info.py). +- **[slackbot.skills.library.add](https://docs.slack.dev/reference/methods/slackbot.skills.library.add)**: Turns a skill on in the caller's personal library. [Implementation](./src/slackbot/skills/library/slackbot_skills_library_add.py). - **[slackbot.skills.list](https://docs.slack.dev/reference/methods/slackbot.skills.list)**: Lists Slackbot skills from the caller's point of view. Instructions are not included. [Implementation](./src/slackbot/skills/slackbot_skills_list.py). - **[slackbot.skills.update](https://docs.slack.dev/reference/methods/slackbot.skills.update)**: Changes a Slackbot skill's instructions or metadata. Only the inputs you send are changed; a call that changes nothing succeeds without writing. [Implementation](./src/slackbot/skills/slackbot_skills_update.py). diff --git a/methods/src/slackbot/skills/library/.slack/.gitignore b/methods/src/slackbot/skills/library/.slack/.gitignore new file mode 100644 index 0000000..973ba60 --- /dev/null +++ b/methods/src/slackbot/skills/library/.slack/.gitignore @@ -0,0 +1,2 @@ +apps.dev.json +cache/ diff --git a/methods/src/slackbot/skills/library/.slack/config.json b/methods/src/slackbot/skills/library/.slack/config.json new file mode 100644 index 0000000..909afbe --- /dev/null +++ b/methods/src/slackbot/skills/library/.slack/config.json @@ -0,0 +1,6 @@ +{ + "manifest": { + "source": "local" + }, + "project_id": "00000000-0000-0000-0000-000000000000" +} diff --git a/methods/src/slackbot/skills/library/.slack/hooks.json b/methods/src/slackbot/skills/library/.slack/hooks.json new file mode 100644 index 0000000..ce474c9 --- /dev/null +++ b/methods/src/slackbot/skills/library/.slack/hooks.json @@ -0,0 +1,5 @@ +{ + "hooks": { + "get-hooks": "python3 -m slack_cli_hooks.hooks.get_hooks" + } +} diff --git a/methods/src/slackbot/skills/library/__init__.py b/methods/src/slackbot/skills/library/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/methods/src/slackbot/skills/library/manifest.json b/methods/src/slackbot/skills/library/manifest.json new file mode 100644 index 0000000..a1620a6 --- /dev/null +++ b/methods/src/slackbot/skills/library/manifest.json @@ -0,0 +1,22 @@ +{ + "display_information": { + "name": "Slack API Methods", + "description": "Example implementations to call \"slackbot.skills.library\" methods" + }, + "features": { + "bot_user": { + "display_name": "Slack API Methods", + "always_online": true + } + }, + "oauth_config": { + "scopes": { + "bot": ["skills:write"] + } + }, + "settings": { + "org_deploy_enabled": true, + "socket_mode_enabled": true, + "token_rotation_enabled": false + } +} diff --git a/methods/src/slackbot/skills/library/slackbot_skills_library_add.py b/methods/src/slackbot/skills/library/slackbot_skills_library_add.py new file mode 100644 index 0000000..0d27640 --- /dev/null +++ b/methods/src/slackbot/skills/library/slackbot_skills_library_add.py @@ -0,0 +1,17 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the slackbot.skills.library.add method +response = client.slackbot_skills_library_add( + skill_id="F0123ABCD", +) + +# Inspect the response +print(response) From 99c24d73771f2ee96f5b394ea4238fb56d5ff5bc Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:12:32 -0800 Subject: [PATCH 06/29] feat: add slackbot.skills.library.remove method example Co-Authored-By: Claude --- methods/README.md | 1 + .../library/slackbot_skills_library_remove.py | 17 +++++++++++++++++ 2 files changed, 18 insertions(+) create mode 100644 methods/src/slackbot/skills/library/slackbot_skills_library_remove.py diff --git a/methods/README.md b/methods/README.md index b150161..43028c0 100644 --- a/methods/README.md +++ b/methods/README.md @@ -48,5 +48,6 @@ $ slack run chat_post_message.py # Make the request - **[slackbot.skills.create](https://docs.slack.dev/reference/methods/slackbot.skills.create)**: Creates a skill from markdown instructions, or turns an existing canvas the caller owns into a skill. [Implementation](./src/slackbot/skills/slackbot_skills_create.py). - **[slackbot.skills.info](https://docs.slack.dev/reference/methods/slackbot.skills.info)**: Returns one Slackbot skill, including its instructions. [Implementation](./src/slackbot/skills/slackbot_skills_info.py). - **[slackbot.skills.library.add](https://docs.slack.dev/reference/methods/slackbot.skills.library.add)**: Turns a skill on in the caller's personal library. [Implementation](./src/slackbot/skills/library/slackbot_skills_library_add.py). +- **[slackbot.skills.library.remove](https://docs.slack.dev/reference/methods/slackbot.skills.library.remove)**: Turns a skill off in the caller's personal library. [Implementation](./src/slackbot/skills/library/slackbot_skills_library_remove.py). - **[slackbot.skills.list](https://docs.slack.dev/reference/methods/slackbot.skills.list)**: Lists Slackbot skills from the caller's point of view. Instructions are not included. [Implementation](./src/slackbot/skills/slackbot_skills_list.py). - **[slackbot.skills.update](https://docs.slack.dev/reference/methods/slackbot.skills.update)**: Changes a Slackbot skill's instructions or metadata. Only the inputs you send are changed; a call that changes nothing succeeds without writing. [Implementation](./src/slackbot/skills/slackbot_skills_update.py). diff --git a/methods/src/slackbot/skills/library/slackbot_skills_library_remove.py b/methods/src/slackbot/skills/library/slackbot_skills_library_remove.py new file mode 100644 index 0000000..49cb2fd --- /dev/null +++ b/methods/src/slackbot/skills/library/slackbot_skills_library_remove.py @@ -0,0 +1,17 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the slackbot.skills.library.remove method +response = client.slackbot_skills_library_remove( + skill_id="F0123ABCD", +) + +# Inspect the response +print(response) From d686b05e097ae6bbd1735914dfc03fb9d1b4108b Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:12:47 -0800 Subject: [PATCH 07/29] feat: add admin.slackbot.skills.list method example Co-Authored-By: Claude --- methods/README.md | 4 ++++ methods/src/admin/__init__.py | 0 methods/src/admin/slackbot/__init__.py | 0 .../admin/slackbot/skills/.slack/.gitignore | 2 ++ .../admin/slackbot/skills/.slack/config.json | 6 +++++ .../admin/slackbot/skills/.slack/hooks.json | 5 ++++ methods/src/admin/slackbot/skills/__init__.py | 0 .../skills/admin_slackbot_skills_list.py | 23 +++++++++++++++++++ .../src/admin/slackbot/skills/manifest.json | 22 ++++++++++++++++++ 9 files changed, 62 insertions(+) create mode 100644 methods/src/admin/__init__.py create mode 100644 methods/src/admin/slackbot/__init__.py create mode 100644 methods/src/admin/slackbot/skills/.slack/.gitignore create mode 100644 methods/src/admin/slackbot/skills/.slack/config.json create mode 100644 methods/src/admin/slackbot/skills/.slack/hooks.json create mode 100644 methods/src/admin/slackbot/skills/__init__.py create mode 100644 methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py create mode 100644 methods/src/admin/slackbot/skills/manifest.json diff --git a/methods/README.md b/methods/README.md index 43028c0..562cbb0 100644 --- a/methods/README.md +++ b/methods/README.md @@ -16,6 +16,10 @@ $ slack run chat_post_message.py # Make the request ## What's on call +### admin + +- **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for skills owned by the organization, including invite-only skills. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_list.py). + ### agents - **[agents.conversations.archive](https://docs.slack.dev/reference/methods/agents.conversations.archive)**: Archive a code channel. [Implementation](./src/agents/conversations/agents_conversations_archive.py). diff --git a/methods/src/admin/__init__.py b/methods/src/admin/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/methods/src/admin/slackbot/__init__.py b/methods/src/admin/slackbot/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/methods/src/admin/slackbot/skills/.slack/.gitignore b/methods/src/admin/slackbot/skills/.slack/.gitignore new file mode 100644 index 0000000..973ba60 --- /dev/null +++ b/methods/src/admin/slackbot/skills/.slack/.gitignore @@ -0,0 +1,2 @@ +apps.dev.json +cache/ diff --git a/methods/src/admin/slackbot/skills/.slack/config.json b/methods/src/admin/slackbot/skills/.slack/config.json new file mode 100644 index 0000000..909afbe --- /dev/null +++ b/methods/src/admin/slackbot/skills/.slack/config.json @@ -0,0 +1,6 @@ +{ + "manifest": { + "source": "local" + }, + "project_id": "00000000-0000-0000-0000-000000000000" +} diff --git a/methods/src/admin/slackbot/skills/.slack/hooks.json b/methods/src/admin/slackbot/skills/.slack/hooks.json new file mode 100644 index 0000000..ce474c9 --- /dev/null +++ b/methods/src/admin/slackbot/skills/.slack/hooks.json @@ -0,0 +1,5 @@ +{ + "hooks": { + "get-hooks": "python3 -m slack_cli_hooks.hooks.get_hooks" + } +} diff --git a/methods/src/admin/slackbot/skills/__init__.py b/methods/src/admin/slackbot/skills/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py b/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py new file mode 100644 index 0000000..2cf8f97 --- /dev/null +++ b/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py @@ -0,0 +1,23 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the admin.slackbot.skills.list method +response = client.admin_slackbot_skills_list( + auto_enabled_status="enabled", + category="productivity", + creator_ids=["U0123ABCD"], + limit=100, + publish_status="published", + sort="usage_count", + sort_dir="desc", +) + +# Inspect the response +print(response) diff --git a/methods/src/admin/slackbot/skills/manifest.json b/methods/src/admin/slackbot/skills/manifest.json new file mode 100644 index 0000000..df47fc8 --- /dev/null +++ b/methods/src/admin/slackbot/skills/manifest.json @@ -0,0 +1,22 @@ +{ + "display_information": { + "name": "Slack API Methods", + "description": "Example implementations to call \"admin.slackbot.skills\" methods" + }, + "features": { + "bot_user": { + "display_name": "Slack API Methods", + "always_online": true + } + }, + "oauth_config": { + "scopes": { + "user": ["admin.skills:read"] + } + }, + "settings": { + "org_deploy_enabled": true, + "socket_mode_enabled": true, + "token_rotation_enabled": false + } +} From 87594b2e1594908feae4d44b706c99467237a516 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:13:03 -0800 Subject: [PATCH 08/29] feat: add admin.slackbot.skills.publish method example Co-Authored-By: Claude --- methods/README.md | 1 + .../skills/admin_slackbot_skills_publish.py | 17 +++++++++++++++++ methods/src/admin/slackbot/skills/manifest.json | 2 +- 3 files changed, 19 insertions(+), 1 deletion(-) create mode 100644 methods/src/admin/slackbot/skills/admin_slackbot_skills_publish.py diff --git a/methods/README.md b/methods/README.md index 562cbb0..f2a8160 100644 --- a/methods/README.md +++ b/methods/README.md @@ -19,6 +19,7 @@ $ slack run chat_post_message.py # Make the request ### admin - **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for skills owned by the organization, including invite-only skills. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_list.py). +- **[admin.slackbot.skills.publish](https://docs.slack.dev/reference/methods/admin.slackbot.skills.publish)**: Publishes Slackbot skills to an organization's catalog. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_publish.py). ### agents diff --git a/methods/src/admin/slackbot/skills/admin_slackbot_skills_publish.py b/methods/src/admin/slackbot/skills/admin_slackbot_skills_publish.py new file mode 100644 index 0000000..4b26720 --- /dev/null +++ b/methods/src/admin/slackbot/skills/admin_slackbot_skills_publish.py @@ -0,0 +1,17 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the admin.slackbot.skills.publish method +response = client.admin_slackbot_skills_publish( + skill_ids=["F0123ABCD"], +) + +# Inspect the response +print(response) diff --git a/methods/src/admin/slackbot/skills/manifest.json b/methods/src/admin/slackbot/skills/manifest.json index df47fc8..d0fe7c2 100644 --- a/methods/src/admin/slackbot/skills/manifest.json +++ b/methods/src/admin/slackbot/skills/manifest.json @@ -11,7 +11,7 @@ }, "oauth_config": { "scopes": { - "user": ["admin.skills:read"] + "user": ["admin.skills:read", "admin.skills:write"] } }, "settings": { From cc1dea29a2bb77106e9e72adb89716adbbdcff69 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:13:20 -0800 Subject: [PATCH 09/29] feat: add admin.slackbot.skills.setAutoEnabled method example Co-Authored-By: Claude --- methods/README.md | 1 + .../admin_slackbot_skills_set_auto_enabled.py | 19 +++++++++++++++++++ 2 files changed, 20 insertions(+) create mode 100644 methods/src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py diff --git a/methods/README.md b/methods/README.md index f2a8160..1dd5e40 100644 --- a/methods/README.md +++ b/methods/README.md @@ -20,6 +20,7 @@ $ slack run chat_post_message.py # Make the request - **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for skills owned by the organization, including invite-only skills. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_list.py). - **[admin.slackbot.skills.publish](https://docs.slack.dev/reference/methods/admin.slackbot.skills.publish)**: Publishes Slackbot skills to an organization's catalog. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_publish.py). +- **[admin.slackbot.skills.setAutoEnabled](https://docs.slack.dev/reference/methods/admin.slackbot.skills.setAutoEnabled)**: Sets who a Slackbot skill is automatically turned on for. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py). ### agents diff --git a/methods/src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py b/methods/src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py new file mode 100644 index 0000000..d74ba8a --- /dev/null +++ b/methods/src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py @@ -0,0 +1,19 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the admin.slackbot.skills.setAutoEnabled method +response = client.admin_slackbot_skills_setAutoEnabled( + permission_type="named_entities", + skill_id="F0123ABCD", + usergroup_ids=["S0123ABCD"], +) + +# Inspect the response +print(response) From 803e925c4f819beee20ae6ba5438da41926f26e7 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:13:36 -0800 Subject: [PATCH 10/29] feat: add admin.slackbot.skills.unpublish method example Co-Authored-By: Claude --- methods/README.md | 1 + .../skills/admin_slackbot_skills_unpublish.py | 17 +++++++++++++++++ 2 files changed, 18 insertions(+) create mode 100644 methods/src/admin/slackbot/skills/admin_slackbot_skills_unpublish.py diff --git a/methods/README.md b/methods/README.md index 1dd5e40..60b36af 100644 --- a/methods/README.md +++ b/methods/README.md @@ -21,6 +21,7 @@ $ slack run chat_post_message.py # Make the request - **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for skills owned by the organization, including invite-only skills. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_list.py). - **[admin.slackbot.skills.publish](https://docs.slack.dev/reference/methods/admin.slackbot.skills.publish)**: Publishes Slackbot skills to an organization's catalog. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_publish.py). - **[admin.slackbot.skills.setAutoEnabled](https://docs.slack.dev/reference/methods/admin.slackbot.skills.setAutoEnabled)**: Sets who a Slackbot skill is automatically turned on for. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py). +- **[admin.slackbot.skills.unpublish](https://docs.slack.dev/reference/methods/admin.slackbot.skills.unpublish)**: Removes Slackbot skills from the org catalog, preserving access, libraries, and deployments. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_unpublish.py). ### agents diff --git a/methods/src/admin/slackbot/skills/admin_slackbot_skills_unpublish.py b/methods/src/admin/slackbot/skills/admin_slackbot_skills_unpublish.py new file mode 100644 index 0000000..f4b0527 --- /dev/null +++ b/methods/src/admin/slackbot/skills/admin_slackbot_skills_unpublish.py @@ -0,0 +1,17 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the admin.slackbot.skills.unpublish method +response = client.admin_slackbot_skills_unpublish( + skill_ids=["F0123ABCD"], +) + +# Inspect the response +print(response) From ee36397aca80de3b5cb6dc3549fe2f2f3bef4da7 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:13:55 -0800 Subject: [PATCH 11/29] feat: add slackbot.skills.delete method example Co-Authored-By: Claude --- methods/README.md | 1 + .../slackbot/skills/slackbot_skills_delete.py | 17 +++++++++++++++++ 2 files changed, 18 insertions(+) create mode 100644 methods/src/slackbot/skills/slackbot_skills_delete.py diff --git a/methods/README.md b/methods/README.md index 60b36af..4e6dce2 100644 --- a/methods/README.md +++ b/methods/README.md @@ -53,6 +53,7 @@ $ slack run chat_post_message.py # Make the request ### slackbot - **[slackbot.skills.create](https://docs.slack.dev/reference/methods/slackbot.skills.create)**: Creates a skill from markdown instructions, or turns an existing canvas the caller owns into a skill. [Implementation](./src/slackbot/skills/slackbot_skills_create.py). +- **[slackbot.skills.delete](https://docs.slack.dev/reference/methods/slackbot.skills.delete)**: Deletes a Slackbot skill and its canvas, and removes it from every library, skill set, and the org catalog. [Implementation](./src/slackbot/skills/slackbot_skills_delete.py). - **[slackbot.skills.info](https://docs.slack.dev/reference/methods/slackbot.skills.info)**: Returns one Slackbot skill, including its instructions. [Implementation](./src/slackbot/skills/slackbot_skills_info.py). - **[slackbot.skills.library.add](https://docs.slack.dev/reference/methods/slackbot.skills.library.add)**: Turns a skill on in the caller's personal library. [Implementation](./src/slackbot/skills/library/slackbot_skills_library_add.py). - **[slackbot.skills.library.remove](https://docs.slack.dev/reference/methods/slackbot.skills.library.remove)**: Turns a skill off in the caller's personal library. [Implementation](./src/slackbot/skills/library/slackbot_skills_library_remove.py). diff --git a/methods/src/slackbot/skills/slackbot_skills_delete.py b/methods/src/slackbot/skills/slackbot_skills_delete.py new file mode 100644 index 0000000..4bd9a04 --- /dev/null +++ b/methods/src/slackbot/skills/slackbot_skills_delete.py @@ -0,0 +1,17 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the slackbot.skills.delete method +response = client.slackbot_skills_delete( + skill_id="F0123ABCD", +) + +# Inspect the response +print(response) From 548b3660b913577743218ada69574752834a6c7d Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:37:53 -0800 Subject: [PATCH 12/29] chore: order slackbot.skills.create example arguments as the reference page does Co-Authored-By: Claude --- methods/src/slackbot/skills/slackbot_skills_create.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/methods/src/slackbot/skills/slackbot_skills_create.py b/methods/src/slackbot/skills/slackbot_skills_create.py index b363acf..99591bc 100644 --- a/methods/src/slackbot/skills/slackbot_skills_create.py +++ b/methods/src/slackbot/skills/slackbot_skills_create.py @@ -11,15 +11,15 @@ # Call the slackbot.skills.create method response = client.slackbot_skills_create( display_name="Daily priorities", - category="productivity", + instructions="# Purpose\nSuggest the three most important things to work on today.", description="Reviews information from Slack and your calendar to suggest priorities for the day.", + category="productivity", example_prompt="Run {skill} for today", - instructions="# Purpose\nSuggest the three most important things to work on today.", mcp_servers=[ { + "service_type": "app", "app_id": "A0123ABCD", "server_id": "Amcp0456EFGH", - "service_type": "app", }, ], ) From e63409ec2c2b0a4f21650931bc9660680b9d9d9b Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:38:11 -0800 Subject: [PATCH 13/29] chore: order slackbot.skills.update example arguments as the reference page does Co-Authored-By: Claude --- methods/src/slackbot/skills/slackbot_skills_update.py | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/methods/src/slackbot/skills/slackbot_skills_update.py b/methods/src/slackbot/skills/slackbot_skills_update.py index 8afe249..030469b 100644 --- a/methods/src/slackbot/skills/slackbot_skills_update.py +++ b/methods/src/slackbot/skills/slackbot_skills_update.py @@ -11,16 +11,16 @@ # Call the slackbot.skills.update method response = client.slackbot_skills_update( skill_id="F0123ABCD", - category="productivity", - description="Reviews information from Slack and your calendar to suggest priorities for the day.", display_name="Daily priorities", - example_prompt="Run {skill} for today", instructions="# Purpose\nSuggest the three most important things to work on today.", + description="Reviews information from Slack and your calendar to suggest priorities for the day.", + category="productivity", + example_prompt="Run {skill} for today", mcp_servers=[ { + "service_type": "app", "app_id": "A0123ABCD", "server_id": "Amcp0456EFGH", - "service_type": "app", }, ], ) From 1f75f54a55ed16d8e14ce54456ac1cacdde6a956 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:38:21 -0800 Subject: [PATCH 14/29] chore: order slackbot.skills.list example arguments as the reference page does Co-Authored-By: Claude --- methods/src/slackbot/skills/slackbot_skills_list.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/methods/src/slackbot/skills/slackbot_skills_list.py b/methods/src/slackbot/skills/slackbot_skills_list.py index 2aa970a..2672a2d 100644 --- a/methods/src/slackbot/skills/slackbot_skills_list.py +++ b/methods/src/slackbot/skills/slackbot_skills_list.py @@ -10,8 +10,8 @@ # Call the slackbot.skills.list method response = client.slackbot_skills_list( - category="productivity", filter="library", + category="productivity", limit=100, ) From 92cdfebbff42f53527c461acf036ff8aecabf25f Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:38:56 -0800 Subject: [PATCH 15/29] chore: order admin.slackbot.skills.list example arguments as the reference page does Co-Authored-By: Claude --- .../src/admin/slackbot/skills/admin_slackbot_skills_list.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py b/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py index 2cf8f97..9270848 100644 --- a/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py +++ b/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py @@ -10,11 +10,11 @@ # Call the admin.slackbot.skills.list method response = client.admin_slackbot_skills_list( - auto_enabled_status="enabled", category="productivity", - creator_ids=["U0123ABCD"], limit=100, + creator_ids=["U0123ABCD"], publish_status="published", + auto_enabled_status="enabled", sort="usage_count", sort_dir="desc", ) From 0f714d19dfe967089b012dde6de2588df55d2f62 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:39:24 -0800 Subject: [PATCH 16/29] chore: order admin.slackbot.skills.setAutoEnabled example arguments as the reference page does Co-Authored-By: Claude --- .../slackbot/skills/admin_slackbot_skills_set_auto_enabled.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/methods/src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py b/methods/src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py index d74ba8a..c62195e 100644 --- a/methods/src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py +++ b/methods/src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py @@ -10,8 +10,8 @@ # Call the admin.slackbot.skills.setAutoEnabled method response = client.admin_slackbot_skills_setAutoEnabled( - permission_type="named_entities", skill_id="F0123ABCD", + permission_type="named_entities", usergroup_ids=["S0123ABCD"], ) From 11bdd96b498bcafe9ddf995983cca2df6126c83c Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:53:05 -0800 Subject: [PATCH 17/29] fix: disable socket mode in the slackbot.skills method examples manifest Co-Authored-By: Claude --- methods/src/slackbot/skills/manifest.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/methods/src/slackbot/skills/manifest.json b/methods/src/slackbot/skills/manifest.json index 217886f..d5f4c6f 100644 --- a/methods/src/slackbot/skills/manifest.json +++ b/methods/src/slackbot/skills/manifest.json @@ -16,7 +16,7 @@ }, "settings": { "org_deploy_enabled": true, - "socket_mode_enabled": true, + "socket_mode_enabled": false, "token_rotation_enabled": false } } From 6a73298a9dac4b2f965ad323bdd1a3bf334b4601 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:53:50 -0800 Subject: [PATCH 18/29] fix: disable socket mode in the slackbot.skills.library method examples manifest Co-Authored-By: Claude --- methods/src/slackbot/skills/library/manifest.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/methods/src/slackbot/skills/library/manifest.json b/methods/src/slackbot/skills/library/manifest.json index a1620a6..91a613c 100644 --- a/methods/src/slackbot/skills/library/manifest.json +++ b/methods/src/slackbot/skills/library/manifest.json @@ -16,7 +16,7 @@ }, "settings": { "org_deploy_enabled": true, - "socket_mode_enabled": true, + "socket_mode_enabled": false, "token_rotation_enabled": false } } From 7dfff7ff874cd1907d0c100a11aacd926819f273 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 20:54:19 -0800 Subject: [PATCH 19/29] fix: disable socket mode in the admin.slackbot.skills method examples manifest Co-Authored-By: Claude --- methods/src/admin/slackbot/skills/manifest.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/methods/src/admin/slackbot/skills/manifest.json b/methods/src/admin/slackbot/skills/manifest.json index df47fc8..90a2aa3 100644 --- a/methods/src/admin/slackbot/skills/manifest.json +++ b/methods/src/admin/slackbot/skills/manifest.json @@ -16,7 +16,7 @@ }, "settings": { "org_deploy_enabled": true, - "socket_mode_enabled": true, + "socket_mode_enabled": false, "token_rotation_enabled": false } } From 16e3d9adda7602175a591ee250f77b6758b1c515 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Wed, 11 Nov 2026 22:24:47 -0800 Subject: [PATCH 20/29] fix: drop the bot user from the admin.slackbot.skills examples manifest The admin methods only use user scopes, and a bot user without a bot scope fails manifest validation (requires_a_bot_scope). Co-Authored-By: Claude --- methods/src/admin/slackbot/skills/manifest.json | 6 ------ 1 file changed, 6 deletions(-) diff --git a/methods/src/admin/slackbot/skills/manifest.json b/methods/src/admin/slackbot/skills/manifest.json index 90a2aa3..1af459f 100644 --- a/methods/src/admin/slackbot/skills/manifest.json +++ b/methods/src/admin/slackbot/skills/manifest.json @@ -3,12 +3,6 @@ "name": "Slack API Methods", "description": "Example implementations to call \"admin.slackbot.skills\" methods" }, - "features": { - "bot_user": { - "display_name": "Slack API Methods", - "always_online": true - } - }, "oauth_config": { "scopes": { "user": ["admin.skills:read"] From b538e964686ee71c97f6a38610dc08fbf48bdc42 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Thu, 12 Nov 2026 19:46:15 -0800 Subject: [PATCH 21/29] feat: add admin.apps.mcp.servers.list method example Co-Authored-By: Claude --- methods/README.md | 1 + methods/src/admin/apps/__init__.py | 0 methods/src/admin/apps/mcp/__init__.py | 0 .../admin/apps/mcp/servers/.slack/.gitignore | 2 ++ .../admin/apps/mcp/servers/.slack/config.json | 6 ++++++ .../admin/apps/mcp/servers/.slack/hooks.json | 5 +++++ methods/src/admin/apps/mcp/servers/__init__.py | 0 .../mcp/servers/admin_apps_mcp_servers_list.py | 17 +++++++++++++++++ .../src/admin/apps/mcp/servers/manifest.json | 16 ++++++++++++++++ 9 files changed, 47 insertions(+) create mode 100644 methods/src/admin/apps/__init__.py create mode 100644 methods/src/admin/apps/mcp/__init__.py create mode 100644 methods/src/admin/apps/mcp/servers/.slack/.gitignore create mode 100644 methods/src/admin/apps/mcp/servers/.slack/config.json create mode 100644 methods/src/admin/apps/mcp/servers/.slack/hooks.json create mode 100644 methods/src/admin/apps/mcp/servers/__init__.py create mode 100644 methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py create mode 100644 methods/src/admin/apps/mcp/servers/manifest.json diff --git a/methods/README.md b/methods/README.md index 4e6dce2..6998c7a 100644 --- a/methods/README.md +++ b/methods/README.md @@ -18,6 +18,7 @@ $ slack run chat_post_message.py # Make the request ### admin +- **[admin.apps.mcp.servers.list](https://docs.slack.dev/reference/methods/admin.apps.mcp.servers.list)**: List third-party app MCP servers approved for an organization. [Implementation](./src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py). - **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for skills owned by the organization, including invite-only skills. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_list.py). - **[admin.slackbot.skills.publish](https://docs.slack.dev/reference/methods/admin.slackbot.skills.publish)**: Publishes Slackbot skills to an organization's catalog. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_publish.py). - **[admin.slackbot.skills.setAutoEnabled](https://docs.slack.dev/reference/methods/admin.slackbot.skills.setAutoEnabled)**: Sets who a Slackbot skill is automatically turned on for. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py). diff --git a/methods/src/admin/apps/__init__.py b/methods/src/admin/apps/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/methods/src/admin/apps/mcp/__init__.py b/methods/src/admin/apps/mcp/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/methods/src/admin/apps/mcp/servers/.slack/.gitignore b/methods/src/admin/apps/mcp/servers/.slack/.gitignore new file mode 100644 index 0000000..973ba60 --- /dev/null +++ b/methods/src/admin/apps/mcp/servers/.slack/.gitignore @@ -0,0 +1,2 @@ +apps.dev.json +cache/ diff --git a/methods/src/admin/apps/mcp/servers/.slack/config.json b/methods/src/admin/apps/mcp/servers/.slack/config.json new file mode 100644 index 0000000..909afbe --- /dev/null +++ b/methods/src/admin/apps/mcp/servers/.slack/config.json @@ -0,0 +1,6 @@ +{ + "manifest": { + "source": "local" + }, + "project_id": "00000000-0000-0000-0000-000000000000" +} diff --git a/methods/src/admin/apps/mcp/servers/.slack/hooks.json b/methods/src/admin/apps/mcp/servers/.slack/hooks.json new file mode 100644 index 0000000..ce474c9 --- /dev/null +++ b/methods/src/admin/apps/mcp/servers/.slack/hooks.json @@ -0,0 +1,5 @@ +{ + "hooks": { + "get-hooks": "python3 -m slack_cli_hooks.hooks.get_hooks" + } +} diff --git a/methods/src/admin/apps/mcp/servers/__init__.py b/methods/src/admin/apps/mcp/servers/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py b/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py new file mode 100644 index 0000000..7e02f29 --- /dev/null +++ b/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py @@ -0,0 +1,17 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the admin.apps.mcp.servers.list method +response = client.admin_apps_mcp_servers_list( + limit=100, +) + +# Inspect the response +print(response) diff --git a/methods/src/admin/apps/mcp/servers/manifest.json b/methods/src/admin/apps/mcp/servers/manifest.json new file mode 100644 index 0000000..5396f1b --- /dev/null +++ b/methods/src/admin/apps/mcp/servers/manifest.json @@ -0,0 +1,16 @@ +{ + "display_information": { + "name": "Slack API Methods", + "description": "Example implementations to call \"admin.apps.mcp.servers\" methods" + }, + "oauth_config": { + "scopes": { + "user": ["admin.apps:read"] + } + }, + "settings": { + "org_deploy_enabled": true, + "socket_mode_enabled": false, + "token_rotation_enabled": false + } +} From 51c8cd0972f7ddc159608968158a8431258e8233 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Thu, 12 Nov 2026 19:46:30 -0800 Subject: [PATCH 22/29] feat: add admin.apps.mcp.servers.permissions.list method example Co-Authored-By: Claude --- methods/README.md | 1 + .../admin_apps_mcp_servers_permissions_list.py | 17 +++++++++++++++++ 2 files changed, 18 insertions(+) create mode 100644 methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_permissions_list.py diff --git a/methods/README.md b/methods/README.md index 6998c7a..e940e27 100644 --- a/methods/README.md +++ b/methods/README.md @@ -19,6 +19,7 @@ $ slack run chat_post_message.py # Make the request ### admin - **[admin.apps.mcp.servers.list](https://docs.slack.dev/reference/methods/admin.apps.mcp.servers.list)**: List third-party app MCP servers approved for an organization. [Implementation](./src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py). +- **[admin.apps.mcp.servers.permissions.list](https://docs.slack.dev/reference/methods/admin.apps.mcp.servers.permissions.list)**: List MCP servers for an app with their access control permissions. [Implementation](./src/admin/apps/mcp/servers/admin_apps_mcp_servers_permissions_list.py). - **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for skills owned by the organization, including invite-only skills. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_list.py). - **[admin.slackbot.skills.publish](https://docs.slack.dev/reference/methods/admin.slackbot.skills.publish)**: Publishes Slackbot skills to an organization's catalog. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_publish.py). - **[admin.slackbot.skills.setAutoEnabled](https://docs.slack.dev/reference/methods/admin.slackbot.skills.setAutoEnabled)**: Sets who a Slackbot skill is automatically turned on for. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_set_auto_enabled.py). diff --git a/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_permissions_list.py b/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_permissions_list.py new file mode 100644 index 0000000..a11a289 --- /dev/null +++ b/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_permissions_list.py @@ -0,0 +1,17 @@ +import os + +from slack_sdk import WebClient + +# Read a token from an environment variable +token = os.environ.get("SLACK_TOKEN") + +# Initialize +client = WebClient(token=token) + +# Call the admin.apps.mcp.servers.permissions.list method +response = client.admin_apps_mcp_servers_permissions_list( + app_id="A0123ABCD", +) + +# Inspect the response +print(response) From ed2ea1426931fe2460abc02b08a7b68daaf03f8a Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 00:48:18 -0800 Subject: [PATCH 23/29] build(deps): bump slack_sdk to 3.47.0 in /methods Co-Authored-By: Claude --- methods/pyproject.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/methods/pyproject.toml b/methods/pyproject.toml index 226f953..2aa9ea5 100644 --- a/methods/pyproject.toml +++ b/methods/pyproject.toml @@ -4,7 +4,7 @@ version = "0.0.0" requires-python = ">=3.10" dependencies = [ "slack_cli_hooks==0.3.0", - "slack_sdk==3.46.0", + "slack_sdk==3.47.0", ] [project.optional-dependencies] From af32c77cc21b650d3229f51129b529c1852bb3c6 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 11:04:54 -0800 Subject: [PATCH 24/29] fix: use docs example app id in admin.apps.mcp.servers.permissions.list example Co-Authored-By: Claude --- .../apps/mcp/servers/admin_apps_mcp_servers_permissions_list.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_permissions_list.py b/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_permissions_list.py index a11a289..9735cf7 100644 --- a/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_permissions_list.py +++ b/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_permissions_list.py @@ -10,7 +10,7 @@ # Call the admin.apps.mcp.servers.permissions.list method response = client.admin_apps_mcp_servers_permissions_list( - app_id="A0123ABCD", + app_id="A0000000001", ) # Inspect the response From 46e0638e2db9e4c842367ffc78264c65793ed539 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 11:33:24 -0800 Subject: [PATCH 25/29] chore(methods): list owned skills in the slackbot.skills.list example Mirrors Michael's suggestion on the Java example (bolt-java-examples#116): filter by owned skills and drop the default limit. Co-authored-by: Michael Brooks <21328+mwbrooks@users.noreply.github.com> Co-Authored-By: Claude --- methods/src/slackbot/skills/slackbot_skills_list.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/methods/src/slackbot/skills/slackbot_skills_list.py b/methods/src/slackbot/skills/slackbot_skills_list.py index 2672a2d..6d04adb 100644 --- a/methods/src/slackbot/skills/slackbot_skills_list.py +++ b/methods/src/slackbot/skills/slackbot_skills_list.py @@ -10,9 +10,8 @@ # Call the slackbot.skills.list method response = client.slackbot_skills_list( - filter="library", + filter="owned", category="productivity", - limit=100, ) # Inspect the response From df6ce7fdeffa2966d7f088d22cdbc85fcd2058b3 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 14:20:41 -0800 Subject: [PATCH 26/29] chore(methods): drop the default limit from the admin.slackbot.skills.list example Co-Authored-By: Claude --- methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py | 1 - 1 file changed, 1 deletion(-) diff --git a/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py b/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py index 9270848..a36d8c4 100644 --- a/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py +++ b/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py @@ -11,7 +11,6 @@ # Call the admin.slackbot.skills.list method response = client.admin_slackbot_skills_list( category="productivity", - limit=100, creator_ids=["U0123ABCD"], publish_status="published", auto_enabled_status="enabled", From b173767badd9c7d9d58ef79ac96ca18877b85a63 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 14:21:08 -0800 Subject: [PATCH 27/29] chore(methods): drop the default limit from the admin.apps.mcp.servers.list example Co-Authored-By: Claude --- .../src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py b/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py index 7e02f29..6dea7ef 100644 --- a/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py +++ b/methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py @@ -9,9 +9,7 @@ client = WebClient(token=token) # Call the admin.apps.mcp.servers.list method -response = client.admin_apps_mcp_servers_list( - limit=100, -) +response = client.admin_apps_mcp_servers_list() # Inspect the response print(response) From c1e783ad26c9f663a2ccf90b3dcf455e48fdc0b6 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 15:31:32 -0800 Subject: [PATCH 28/29] chore(methods): drop extra filters from the admin.slackbot.skills.list example Co-Authored-By: Claude --- .../src/admin/slackbot/skills/admin_slackbot_skills_list.py | 4 ---- 1 file changed, 4 deletions(-) diff --git a/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py b/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py index a36d8c4..6bbaccc 100644 --- a/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py +++ b/methods/src/admin/slackbot/skills/admin_slackbot_skills_list.py @@ -12,10 +12,6 @@ response = client.admin_slackbot_skills_list( category="productivity", creator_ids=["U0123ABCD"], - publish_status="published", - auto_enabled_status="enabled", - sort="usage_count", - sort_dir="desc", ) # Inspect the response From 70538cf6a443186b1abcd4e3ffb85c5fb3810c94 Mon Sep 17 00:00:00 2001 From: Eden Zimbelman Date: Fri, 13 Nov 2026 16:01:50 -0800 Subject: [PATCH 29/29] docs(methods): use the docs summary for the admin.slackbot.skills.list readme entry Co-Authored-By: Claude --- methods/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/methods/README.md b/methods/README.md index 6f70f95..3b63634 100644 --- a/methods/README.md +++ b/methods/README.md @@ -19,7 +19,7 @@ $ slack run chat_post_message.py # Make the request ### admin - **[admin.conversations.bulkSetProperties](https://docs.slack.dev/reference/methods/admin.conversations.bulkSetProperties)**: Set properties on channels in bulk. [Implementation](./src/admin/conversations/admin_conversations_bulk_set_properties.py). -- **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for skills owned by the organization, including invite-only skills. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_list.py). +- **[admin.slackbot.skills.list](https://docs.slack.dev/reference/methods/admin.slackbot.skills.list)**: Lists metadata for Slackbot skills owned by an organization. [Implementation](./src/admin/slackbot/skills/admin_slackbot_skills_list.py). ### agents