{"id":13421,"date":"2026-06-02T10:09:43","date_gmt":"2026-06-02T08:09:43","guid":{"rendered":"https:\/\/pumble.com\/help\/?p=13421"},"modified":"2026-06-10T09:19:48","modified_gmt":"2026-06-10T07:19:48","slug":"how-to-use-the-pumble-mcp-server","status":"publish","type":"post","link":"https:\/\/pumble.com\/help\/integrations\/automation-workflow-integrations\/how-to-use-the-pumble-mcp-server\/","title":{"rendered":"How to use the Pumble MCP server"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">With the Pumble Model Context Protocol (MCP) server, you can connect third-party AI agents (e.g., Claude, Gemini, Codex) to Pumble and let them access content so they can search messages, find information, and take actions on your behalf.<\/p>\n\n\n\n<h2 class=\"wp-block-heading translation-block\">How to connect to an MCP server<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">To connect your AI assistant to the Pumble MCP server, you will have to create a Pumble addon and take credentials from there. To do this, you will first need to access Pumble addons.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li class=\"translation-block\">Click on the <strong>three<\/strong> <strong>dots<\/strong> next to the Workspace name<\/li>\n\n\n\n<li class=\"translation-block\">Hover over <strong>Workspace<\/strong> <strong>settings<\/strong><\/li>\n\n\n\n<li class=\"translation-block\">Select <strong>Configure<\/strong> <strong>apps<\/strong><br><img loading=\"lazy\" decoding=\"async\" width=\"250\" height=\"223\" class=\"wp-image-13451\" style=\"width: 250px;\" src=\"https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/configure-apps-1.jpeg\" alt=\"configure apps\" srcset=\"https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/configure-apps-1.jpeg 1012w, https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/configure-apps-1-300x268.jpeg 300w, https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/configure-apps-1-768x686.jpeg 768w, https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/configure-apps-1-13x12.jpeg 13w\" sizes=\"auto, (max-width: 250px) 100vw, 250px\" \/><\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Once you have opened the Configure apps page, you can add your own addon. Here\u2019s how:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li class=\"translation-block\">Click on <strong>+ Create app<\/strong><\/li>\n\n\n\n<li class=\"translation-block\">Select <strong>Create from scratch<\/strong><br><img loading=\"lazy\" decoding=\"async\" width=\"250\" height=\"427\" class=\"wp-image-13455\" style=\"width: 250px;\" src=\"https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/create-app-from-scratch.jpeg\" alt=\"\" srcset=\"https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/create-app-from-scratch.jpeg 852w, https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/create-app-from-scratch-176x300.jpeg 176w, https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/create-app-from-scratch-600x1024.jpeg 600w, https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/create-app-from-scratch-768x1311.jpeg 768w, https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/create-app-from-scratch-7x12.jpeg 7w\" sizes=\"auto, (max-width: 250px) 100vw, 250px\" \/><\/li>\n\n\n\n<li>Enter app name<\/li>\n\n\n\n<li>Enter description<\/li>\n\n\n\n<li>Select User scopes<\/li>\n\n\n\n<li>Select Bot scopes<\/li>\n\n\n\n<li class=\"translation-block\">Click on <strong>Install app<\/strong><br><img loading=\"lazy\" decoding=\"async\" width=\"250\" height=\"376\" class=\"wp-image-13454\" style=\"width: 250px;\" src=\"https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/install-app.jpeg\" alt=\"install app\n\" srcset=\"https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/install-app.jpeg 852w, https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/install-app-199x300.jpeg 199w, https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/install-app-681x1024.jpeg 681w, https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/install-app-768x1156.jpeg 768w, https:\/\/pumble.com\/help\/wp-content\/uploads\/2026\/06\/install-app-8x12.jpeg 8w\" sizes=\"auto, (max-width: 250px) 100vw, 250px\" \/><\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">When the app is installed, make sure to copy the App key, user token, and bot token.<\/p>\n\n\n\n<h2 class=\"wp-block-heading translation-block\">What can you do after connecting to the MCP server?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The list of available MCP tools is dynamic and depends entirely on the specific scopes you selected when creating an app.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">These are all the available tools that the Pumble MCP server lets you use:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>add_reaction_to_message<\/li>\n\n\n\n<li>add_user_to_channel<\/li>\n\n\n\n<li>create_call_link<\/li>\n\n\n\n<li>create_channel<\/li>\n\n\n\n<li>delete_scheduled_message<\/li>\n\n\n\n<li>edit_message<\/li>\n\n\n\n<li>fetch_file<\/li>\n\n\n\n<li>get_channel_details<\/li>\n\n\n\n<li>get_channel_messages<\/li>\n\n\n\n<li>get_channels<\/li>\n\n\n\n<li>get_latest_messages<\/li>\n\n\n\n<li>get_scheduled_messages<\/li>\n\n\n\n<li>get_thread_replies<\/li>\n\n\n\n<li>get_users<\/li>\n\n\n\n<li>get_workspace_info<\/li>\n\n\n\n<li>reply_to_message<\/li>\n\n\n\n<li>schedule_message<\/li>\n\n\n\n<li>search_messages<\/li>\n\n\n\n<li>send_message<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Moreover, you can use the following prompts to communicate with the MCP server:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>create-channel-with-initial-users<\/li>\n\n\n\n<li>explain-pumble-mcp<\/li>\n\n\n\n<li>send-channel-message<\/li>\n\n\n\n<li>Send-dm-message<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading translation-block\">Connect Pumble MCP to Claude CLI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">If you are using Claude CLI, you can also connect it to the Pumble MCP server. To do this, paste the code below into your .mcp.json file.<\/p>\n\n\n\n<div class=\"wp-block-custom-auto-code-block auto-code-wrapper\"><div class=\"code-header\"><span class=\"code-lang\"><\/span><button class=\"copy-btn\" onclick=\"copyCodeToClipboard(this)\"><svg width=\"17\" height=\"17\" viewBox=\"0 0 17 17\" fill=\"none\" style=\"margin-right:8px\"><mask id=\"mask-copy-save\" style=\"mask-type:alpha\" maskUnits=\"userSpaceOnUse\" x=\"0\" y=\"0\" width=\"17\" height=\"17\"><rect width=\"17\" height=\"17\" fill=\"#D9D9D9\"><\/rect><\/mask><g mask=\"url(#mask-copy-save)\"><path d=\"M6.375 12.7508C5.98542 12.7508 5.65191 12.6121 5.37448 12.3347C5.09705 12.0572 4.95833 11.7237 4.95833 11.3341V2.83415C4.95833 2.44456 5.09705 2.11106 5.37448 1.83363C5.65191 1.5562 5.98542 1.41748 6.375 1.41748H12.75C13.1396 1.41748 13.4731 1.5562 13.7505 1.83363C14.028 2.11106 14.1667 2.44456 14.1667 2.83415V11.3341C14.1667 11.7237 14.028 12.0572 13.7505 12.3347C13.4731 12.6121 13.1396 12.7508 12.75 12.7508H6.375ZM6.375 11.3341H12.75V2.83415H6.375V11.3341ZM3.54167 15.5841C3.15208 15.5841 2.81858 15.4454 2.54115 15.168C2.26372 14.8906 2.125 14.5571 2.125 14.1675V4.25081H3.54167V14.1675H11.3333V15.5841H3.54167Z\" fill=\"black\"><\/path><\/g><\/svg>Copy<\/button><\/div><div class=\"code-scroll-area\"><pre class=\"language-\"><code class=\"language-\">{\n  \"mcpServers\": {\n    \"pumble-mcp\": {\n      \"type\": \"http\",\n      \"url\": \"https:\/\/mcp.pumble.com\/mcp\",\n      \"headers\": {\n        \"token\": \"user\/bot token\"\n\t\"x-app-token\": \"xpat-token\"\n      }\n    }\n  }\n}<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Or, you can use the following command:<\/p>\n\n\n\n<div class=\"wp-block-custom-auto-code-block auto-code-wrapper\"><div class=\"code-header\"><span class=\"code-lang\"><\/span><button class=\"copy-btn\" onclick=\"copyCodeToClipboard(this)\"><svg width=\"17\" height=\"17\" viewBox=\"0 0 17 17\" fill=\"none\" style=\"margin-right:8px\"><mask id=\"mask-copy-save\" style=\"mask-type:alpha\" maskUnits=\"userSpaceOnUse\" x=\"0\" y=\"0\" width=\"17\" height=\"17\"><rect width=\"17\" height=\"17\" fill=\"#D9D9D9\"><\/rect><\/mask><g mask=\"url(#mask-copy-save)\"><path d=\"M6.375 12.7508C5.98542 12.7508 5.65191 12.6121 5.37448 12.3347C5.09705 12.0572 4.95833 11.7237 4.95833 11.3341V2.83415C4.95833 2.44456 5.09705 2.11106 5.37448 1.83363C5.65191 1.5562 5.98542 1.41748 6.375 1.41748H12.75C13.1396 1.41748 13.4731 1.5562 13.7505 1.83363C14.028 2.11106 14.1667 2.44456 14.1667 2.83415V11.3341C14.1667 11.7237 14.028 12.0572 13.7505 12.3347C13.4731 12.6121 13.1396 12.7508 12.75 12.7508H6.375ZM6.375 11.3341H12.75V2.83415H6.375V11.3341ZM3.54167 15.5841C3.15208 15.5841 2.81858 15.4454 2.54115 15.168C2.26372 14.8906 2.125 14.5571 2.125 14.1675V4.25081H3.54167V14.1675H11.3333V15.5841H3.54167Z\" fill=\"black\"><\/path><\/g><\/svg>Copy<\/button><\/div><div class=\"code-scroll-area\"><pre class=\"language-\"><code class=\"language-\">claude mcp add pumble-mcp https:\/\/mcp.pumble.com\/mcp --transport http --header \"token: token\" --header \"x-app-token: xpat-token\"<\/code><\/pre><\/div><\/div>\n\n\n\n<div class=\"wp-block-custom-highlight-box custom-box color-indigo\"><div class=\"box-header\"><svg width=\"20\" height=\"20\" viewBox=\"0 0 24 24\" fill=\"none\"><mask id=\"mask-indigo\" style=\"mask-type:alpha\" maskUnits=\"userSpaceOnUse\" x=\"0\" y=\"0\" width=\"24\" height=\"24\"><rect width=\"24\" height=\"24\" fill=\"#D9D9D9\"><\/rect><\/mask><g mask=\"url(#mask-indigo)\"><path d=\"M12 17C12.2833 17 12.5208 16.9042 12.7125 16.7125C12.9042 16.5208 13 16.2833 13 16C13 15.7167 12.9042 15.4792 12.7125 15.2875C12.5208 15.0958 12.2833 15 12 15C11.7167 15 11.4792 15.0958 11.2875 15.2875C11.0958 15.4792 11 15.7167 11 16C11 16.2833 11.0958 16.5208 11.2875 16.7125C11.4792 16.9042 11.7167 17 12 17ZM11 13H13V7H11V13ZM12 22C10.6167 22 9.31667 21.7375 8.1 21.2125C6.88333 20.6875 5.825 19.975 4.925 19.075C4.025 18.175 3.3125 17.1167 2.7875 15.9C2.2625 14.6833 2 13.3833 2 12C2 10.6167 2.2625 9.31667 2.7875 8.1C3.3125 6.88333 4.025 5.825 4.925 4.925C5.825 4.025 6.88333 3.3125 8.1 2.7875C9.31667 2.2625 10.6167 2 12 2C13.3833 2 14.6833 2.2625 15.9 2.7875C17.1167 3.3125 18.175 4.025 19.075 4.925C19.975 5.825 20.6875 6.88333 21.2125 8.1C21.7375 9.31667 22 10.6167 22 12C22 13.3833 21.7375 14.6833 21.2125 15.9C20.6875 17.1167 19.975 18.175 19.075 19.075C18.175 19.975 17.1167 20.6875 15.9 21.2125C14.6833 21.7375 13.3833 22 12 22ZM12 20C14.2333 20 16.125 19.225 17.675 17.675C19.225 16.125 20 14.2333 20 12C20 9.76667 19.225 7.875 17.675 6.325C16.125 4.775 14.2333 4 12 4C9.76667 4 7.875 4.775 6.325 6.325C4.775 7.875 4 9.76667 4 12C4 14.2333 4.775 16.125 6.325 17.675C7.875 19.225 9.76667 20 12 20Z\" fill=\"#3F51B5\"><\/path><\/g><\/svg><span class=\"box-label\">Info<\/span><\/div><div class=\"box-content\">\n<p class=\"translation-block wp-block-paragraph\">The x-app-token\/xpat token is the <strong>App key<\/strong> you receive when you create an app from scratch.<\/p>\n<\/div><\/div>\n\n\n\n<h2 class=\"wp-block-heading translation-block\">Connect Pumble MCP to Codex CLI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The Pumble MCP server can also connect to the Codex CLI. To do this, simply paste the code below into your config.toml file.<\/p>\n\n\n\n<div class=\"wp-block-custom-auto-code-block auto-code-wrapper\"><div class=\"code-header\"><span class=\"code-lang\"><\/span><button class=\"copy-btn\" onclick=\"copyCodeToClipboard(this)\"><svg width=\"17\" height=\"17\" viewBox=\"0 0 17 17\" fill=\"none\" style=\"margin-right:8px\"><mask id=\"mask-copy-save\" style=\"mask-type:alpha\" maskUnits=\"userSpaceOnUse\" x=\"0\" y=\"0\" width=\"17\" height=\"17\"><rect width=\"17\" height=\"17\" fill=\"#D9D9D9\"><\/rect><\/mask><g mask=\"url(#mask-copy-save)\"><path d=\"M6.375 12.7508C5.98542 12.7508 5.65191 12.6121 5.37448 12.3347C5.09705 12.0572 4.95833 11.7237 4.95833 11.3341V2.83415C4.95833 2.44456 5.09705 2.11106 5.37448 1.83363C5.65191 1.5562 5.98542 1.41748 6.375 1.41748H12.75C13.1396 1.41748 13.4731 1.5562 13.7505 1.83363C14.028 2.11106 14.1667 2.44456 14.1667 2.83415V11.3341C14.1667 11.7237 14.028 12.0572 13.7505 12.3347C13.4731 12.6121 13.1396 12.7508 12.75 12.7508H6.375ZM6.375 11.3341H12.75V2.83415H6.375V11.3341ZM3.54167 15.5841C3.15208 15.5841 2.81858 15.4454 2.54115 15.168C2.26372 14.8906 2.125 14.5571 2.125 14.1675V4.25081H3.54167V14.1675H11.3333V15.5841H3.54167Z\" fill=\"black\"><\/path><\/g><\/svg>Copy<\/button><\/div><div class=\"code-scroll-area\"><pre class=\"language-\"><code class=\"language-\">[mcp_servers.pumble-mcp]\ntransport = \"http\"\nurl = \"https:\/\/mcp.pumble.com\/mcp\"\nhttp_headers = { \"token\" = \"user\/bot token\", \"x-app-token\" = \"xpat-token\" }<\/code><\/pre><\/div><\/div>\n\n\n\n<h2 class=\"wp-block-heading translation-block\">Connect Pumble MCP to Gemini CLI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">When you have created the custom addon, you can connect it to your Gemini CLI. To do so, paste the code below into your settings.json file.<\/p>\n\n\n\n<div class=\"wp-block-custom-auto-code-block auto-code-wrapper\"><div class=\"code-header\"><span class=\"code-lang\"><\/span><button class=\"copy-btn\" onclick=\"copyCodeToClipboard(this)\"><svg width=\"17\" height=\"17\" viewBox=\"0 0 17 17\" fill=\"none\" style=\"margin-right:8px\"><mask id=\"mask-copy-save\" style=\"mask-type:alpha\" maskUnits=\"userSpaceOnUse\" x=\"0\" y=\"0\" width=\"17\" height=\"17\"><rect width=\"17\" height=\"17\" fill=\"#D9D9D9\"><\/rect><\/mask><g mask=\"url(#mask-copy-save)\"><path d=\"M6.375 12.7508C5.98542 12.7508 5.65191 12.6121 5.37448 12.3347C5.09705 12.0572 4.95833 11.7237 4.95833 11.3341V2.83415C4.95833 2.44456 5.09705 2.11106 5.37448 1.83363C5.65191 1.5562 5.98542 1.41748 6.375 1.41748H12.75C13.1396 1.41748 13.4731 1.5562 13.7505 1.83363C14.028 2.11106 14.1667 2.44456 14.1667 2.83415V11.3341C14.1667 11.7237 14.028 12.0572 13.7505 12.3347C13.4731 12.6121 13.1396 12.7508 12.75 12.7508H6.375ZM6.375 11.3341H12.75V2.83415H6.375V11.3341ZM3.54167 15.5841C3.15208 15.5841 2.81858 15.4454 2.54115 15.168C2.26372 14.8906 2.125 14.5571 2.125 14.1675V4.25081H3.54167V14.1675H11.3333V15.5841H3.54167Z\" fill=\"black\"><\/path><\/g><\/svg>Copy<\/button><\/div><div class=\"code-scroll-area\"><pre class=\"language-\"><code class=\"language-\">{\n  \"mcpServers\": {\n    \"pumble-mcp\": {\n      \"httpUrl\": \"https:\/\/mcp.pumble.com\/mcp\",\n      \"headers\": {\n        \"token\": \"user\/bot token\",\n        \"x-app-token\": \"xpat-token\"\n      },\n    }\n  }\n}\n<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp;You can also do this by using the command:<\/p>\n\n\n\n<div class=\"wp-block-custom-auto-code-block auto-code-wrapper\"><div class=\"code-header\"><span class=\"code-lang\"><\/span><button class=\"copy-btn\" onclick=\"copyCodeToClipboard(this)\"><svg width=\"17\" height=\"17\" viewBox=\"0 0 17 17\" fill=\"none\" style=\"margin-right:8px\"><mask id=\"mask-copy-save\" style=\"mask-type:alpha\" maskUnits=\"userSpaceOnUse\" x=\"0\" y=\"0\" width=\"17\" height=\"17\"><rect width=\"17\" height=\"17\" fill=\"#D9D9D9\"><\/rect><\/mask><g mask=\"url(#mask-copy-save)\"><path d=\"M6.375 12.7508C5.98542 12.7508 5.65191 12.6121 5.37448 12.3347C5.09705 12.0572 4.95833 11.7237 4.95833 11.3341V2.83415C4.95833 2.44456 5.09705 2.11106 5.37448 1.83363C5.65191 1.5562 5.98542 1.41748 6.375 1.41748H12.75C13.1396 1.41748 13.4731 1.5562 13.7505 1.83363C14.028 2.11106 14.1667 2.44456 14.1667 2.83415V11.3341C14.1667 11.7237 14.028 12.0572 13.7505 12.3347C13.4731 12.6121 13.1396 12.7508 12.75 12.7508H6.375ZM6.375 11.3341H12.75V2.83415H6.375V11.3341ZM3.54167 15.5841C3.15208 15.5841 2.81858 15.4454 2.54115 15.168C2.26372 14.8906 2.125 14.5571 2.125 14.1675V4.25081H3.54167V14.1675H11.3333V15.5841H3.54167Z\" fill=\"black\"><\/path><\/g><\/svg>Copy<\/button><\/div><div class=\"code-scroll-area\"><pre class=\"language-\"><code class=\"language-\">gemini mcp add pumble-mcp https:\/\/mcp.pumble.com\/mcp \\\n  --transport http \\\n  --header \"token: token\n\" \\\n  --header \"x-app-token: xpat-token\"<\/code><\/pre><\/div><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">To connect Pumble MCP to your CLI, you will need the App key and user\/bot tokens.<\/p>\n","protected":false},"excerpt":{"rendered":"With the Pumble Model Context Protocol (MCP) server, you can connect third-party&#8230;","protected":false},"author":42,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_helpful_status":1,"_searchwp_excluded":"","footnotes":""},"categories":[64],"tags":[],"class_list":["post-13421","post","type-post","status-publish","format-standard","hentry","category-automation-workflow-integrations"],"acf":[],"featured_image_src":null,"author_info":{"display_name":"Milos Milosavljevic","author_link":"https:\/\/pumble.com\/help\/author\/milos-milosavljevic\/"},"_links":{"self":[{"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/posts\/13421","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/users\/42"}],"replies":[{"embeddable":true,"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/comments?post=13421"}],"version-history":[{"count":21,"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/posts\/13421\/revisions"}],"predecessor-version":[{"id":13503,"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/posts\/13421\/revisions\/13503"}],"wp:attachment":[{"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/media?parent=13421"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/categories?post=13421"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/tags?post=13421"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}