{"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-02T10:37:15","modified_gmt":"2026-06-02T08:37:15","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\">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>Click on the <strong>three<\/strong> <strong>dots<\/strong> next to the Workspace name<\/li>\n\n\n\n<li>Hover over <strong>Workspace<\/strong> <strong>settings<\/strong><\/li>\n\n\n\n<li>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>Click on <strong>+ Create app<\/strong><\/li>\n\n\n\n<li>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>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\">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\">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\n\n\n<h2 class=\"wp-block-heading\">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<h2 class=\"wp-block-heading\">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","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":8,"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/posts\/13421\/revisions"}],"predecessor-version":[{"id":13484,"href":"https:\/\/pumble.com\/help\/wp-json\/wp\/v2\/posts\/13421\/revisions\/13484"}],"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}]}}