# How to integrate Botbaba MCP with Codex ```json { "title": "How to integrate Botbaba MCP with Codex", "toolkit": "Botbaba", "toolkit_slug": "botbaba", "framework": "Codex", "framework_slug": "codex", "url": "https://composio.dev/toolkits/botbaba/framework/codex", "markdown_url": "https://composio.dev/toolkits/botbaba/framework/codex.md", "updated_at": "2026-05-12T10:03:42.974Z" } ``` ## Introduction Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Botbaba MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer. ## Also integrate Botbaba with - [OpenAI Agents SDK](https://composio.dev/toolkits/botbaba/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/botbaba/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/botbaba/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/botbaba/framework/claude-cowork) - [OpenClaw](https://composio.dev/toolkits/botbaba/framework/openclaw) - [Hermes](https://composio.dev/toolkits/botbaba/framework/hermes-agent) - [CLI](https://composio.dev/toolkits/botbaba/framework/cli) - [Google ADK](https://composio.dev/toolkits/botbaba/framework/google-adk) - [LangChain](https://composio.dev/toolkits/botbaba/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/botbaba/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/botbaba/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/botbaba/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/botbaba/framework/crew-ai) ## TL;DR ### Why use Composio? Apart from a managed and hosted MCP server, you will get: - CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling. - Large tool responses: Handle them to minimise context rot. - Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need. ## Connect Botbaba to Codex ### How to install Botbaba MCP in Codex ### Run the setup command Run this command in your terminal to add the Composio MCP server to Codex. ```bash codex mcp add composio --url https://connect.composio.dev/mcp ``` ## What is the Botbaba MCP server, and what's possible with it? The Botbaba MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Botbaba account. It provides structured and secure access to your chatbot management platform, so your agent can perform actions like creating bots, updating conversation flows, managing integrations, deploying changes, and monitoring chatbot analytics on your behalf. - Bot creation and configuration: Instantly create new chatbots, set up welcome messages, and configure basic settings directly from your agent. - Conversational flow management: Update, organize, or refine conversation trees, intents, and responses for smarter, more natural chatbot interactions. - Integration with messaging platforms: Enable your agent to connect bots with channels like WhatsApp, Facebook Messenger, and web chat for seamless communication. - Real-time deployment and publishing: Push bot changes live or roll back updates—ensuring your chatbots stay current and relevant with minimal effort. - Analytics and performance monitoring: Automatically fetch usage statistics, analyze user engagement, and monitor bot performance to optimize conversational experiences. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `BOTBABA_CART_CREATION_EVENT_SIMULATOR` | Shopify Cart Creation Simulator | Tool to simulate a Shopify cart creation webhook payload. Use when generating test payloads for BOTBABA_CART_CREATION_SHOPIFY_WEBHOOK. | | `BOTBABA_CART_CREATION_SHOPIFY_WEBHOOK` | Cart Creation Shopify Webhook | Tool to receive Shopify Cart Creation webhooks. Use when configuring Shopify webhook for Cart Creation events and forwarding the payload to Botbaba. Must be called upon receiving Shopify payload. | | `BOTBABA_CART_UPDATE_SHOPIFY_WEBHOOK` | Cart Update Shopify Webhook | Tool to forward Shopify cart update events to BotBaba. Use when processing Shopify Cart Update webhook after configuring the webhook in your store. | | `BOTBABA_CHECKOUT_CREATION_SHOPIFY_WEBHOOK` | Shopify Checkout Creation Webhook Receiver | Tool to receive Shopify checkout creation webhook events. Use when configuring your Shopify store to notify BotBaba of checkout creation events. | | `BOTBABA_CHECKOUT_UPDATE_SHOPIFY_WEBHOOK` | Checkout Update Shopify Webhook | Tool to forward Shopify checkout/update events to Botbaba. Use when handling Shopify checkout update notifications. | | `BOTBABA_DELETE_BROADCAST` | Delete a broadcast campaign | Tool to delete a broadcast campaign. Use when you need to permanently remove a Botbaba broadcast by its ID after confirming it exists. | | `BOTBABA_DELETE_CONTACT` | Delete Contact | Tool to delete a contact. Use when you have the contact ID and want to remove it from Botbaba. | | `BOTBABA_DELETE_FLOW` | Delete a conversation flow | Tool to delete a conversation flow. Use when you need to permanently remove a Botbaba flow by its ID after confirming it exists. | | `BOTBABA_DELETE_TAG` | Delete Tag | Tool to delete a tag. Use when you have a tag ID and want to remove it from Botbaba. Tries multiple known Botbaba endpoint variations to improve compatibility across deployments. | | `BOTBABA_DELETE_TEMPLATE` | Delete Template | Tool to delete a message template. Use when you have the template ID and want to remove it from Botbaba. Tries multiple known Botbaba endpoint variations to improve compatibility across deployments. | | `BOTBABA_DELETE_WEBHOOK` | Delete a webhook subscription | Tool to delete a webhook subscription. Use when you have the webhook ID and want to remove it from Botbaba. | | `BOTBABA_EXECUTE_BOT_ACTION` | Execute Bot Action | Tool to execute a bot action or workflow. Use when triggering automated actions or workflows for a specific conversation. | | `BOTBABA_EXECUTE_BOT_ACTION_BY_USER` | Execute Bot Action By User | Tool to execute a bot action for specific users. Use when you need to trigger actions for one or multiple bot users. | | `BOTBABA_GET_BOT_WIDGET_SETTINGS` | Get Bot Widget Settings | Tool to retrieve widget configuration settings for a bot. Use when you need to check or verify the widget display settings, styling, or behavior configuration for a specific bot. | | `BOTBABA_GET_BROADCAST` | Get Broadcast | Tool to retrieve details of a specific broadcast. Use when you need to confirm broadcast settings or status after creating or scheduling a broadcast. | | `BOTBABA_GET_CONTACT` | Get BotBaba Contact | Tool to fetch a BotBaba contact by its ID. Use when you need to retrieve the full details of a contact after creation or update. | | `BOTBABA_GET_CONTACT_ANALYTICS` | Get Contact Analytics | Tool to retrieve analytics data for contacts. Use when you need summary metrics (e.g., new or active contacts) over a date range. Note: BotBaba API does not have a dedicated contact analytics endpoint. This action aggregates data from messages and tags to provide contact interaction metrics. | | `BOTBABA_GET_FILENAME` | Get Filename from Path | Tool to extract the filename from a file path. Use when you need to parse a file path and retrieve just the filename component. | | `BOTBABA_GET_FLOW` | Get Flow | Tool to retrieve details of a specific flow. Use when you need the full configuration for a given flow ID. | | `BOTBABA_GET_MESSAGE` | Get Message | Tool to retrieve status of a specific message. Use after sending a message to check its delivery status. | | `BOTBABA_GET_MESSAGE_ANALYTICS` | Get Message Analytics | Tool to retrieve analytics data for a specific message. Use after sending a message to analyze its delivery and engagement statistics. | | `BOTBABA_GET_TEMPLATE` | Get Template | Tool to retrieve details of a specific template. Use when you need to confirm template details before sending a message using a template. | | `BOTBABA_GET_WEBHOOK` | Get Webhook | Tool to retrieve details of a specific webhook. Use when you need to confirm webhook configuration before debugging event deliveries. | | `BOTBABA_LIST_BROADCASTS` | List Broadcasts | Tool to list all broadcast campaigns. Use when retrieving BotBaba broadcast campaigns with pagination. | | `BOTBABA_LIST_FLOWS` | List Flows | Tool to list all conversation flows with their IDs and metadata. Use when you need to retrieve all available flows from your BotBaba account. | | `BOTBABA_LIST_TAGS` | List Tags | Tool to list all tags. Use when you need to retrieve all tags available in your Botbaba account. | | `BOTBABA_LIST_TEMPLATES` | List Templates | Tool to retrieve a paginated list of templates. Use when you need to browse or manage existing templates; supports optional search filtering. | | `BOTBABA_LIST_WEBHOOK_EVENT_TYPES` | List Webhook Event Types | Tool to list available webhook event types. Use before creating or updating a webhook to ensure you subscribe to valid event identifiers. | | `BOTBABA_LIST_WEBHOOKS` | List Webhooks | Tool to list all registered webhooks. Use when you need to retrieve and manage webhook subscriptions in your BotBaba account. | | `BOTBABA_ORDER_CANCELLATION_SHOPIFY_WEBHOOK` | Receive Shopify Order Cancellation Webhook | Tool to receive Shopify order cancellation webhooks. Use when handling Shopify orders/cancelled events from your store. | | `BOTBABA_ORDER_FULFILLMENT_EVENT_SIMULATOR` | Order Fulfillment Simulator | Tool to simulate a Shopify order fulfillment webhook payload. Use when generating test payloads for BOTBABA_ORDER_FULFILLMENT_SHOPIFY_WEBHOOK. | | `BOTBABA_ORDER_FULFILLMENT_SHOPIFY_WEBHOOK` | Order Fulfillment Shopify Webhook | Tool to receive Shopify Order Fulfillment webhooks. Use when handling Shopify fulfillments/create or fulfillments/update events from your store. This action acknowledges receipt of the webhook and extracts key fulfillment details. | | `BOTBABA_ORDER_PAYMENT_SHOPIFY_WEBHOOK` | Order Payment Shopify Webhook | Tool to receive Shopify Order Payment webhooks. Use when handling Shopify orders/paid events from your store. This action acknowledges receipt of the webhook and extracts key payment details from the order. | | `BOTBABA_SEND_WHATSAPP_TEMPLATE_MESSAGES` | Send WhatsApp Template Message | Tool to forward/send a WhatsApp template message via Botbaba. Use after copying the full message JSON from the Template UI. | | `BOTBABA_SHOPIFY_CHECKOUT_CREATION_EVENT_SIMULATOR` | Shopify Checkout Creation Simulator | Tool to simulate a Shopify checkout creation webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_CREATION_SHOPIFY_WEBHOOK. | | `BOTBABA_SHOPIFY_CHECKOUT_UPDATE_EVENT_SIMULATOR` | Shopify Checkout Update Simulator | Tool to simulate a Shopify checkout update webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_UPDATE_SHOPIFY_WEBHOOK. | | `BOTBABA_UPDATE_CONTACT` | Update Contact | Tool to update an existing contact. Use when needing to modify contact details after confirming contact_id. | | `BOTBABA_UPDATE_TAG` | Update Tag | Tool to update an existing tag. Use when renaming a tag after confirming its tag ID. | | `BOTBABA_UPDATE_TEMPLATE` | Update Template | Tool to update an existing message template. Use when you need to modify template details after confirming its template ID. Tries multiple base URLs, HTTP methods, and path variants to be resilient across different Botbaba deployments. | | `BOTBABA_UPDATE_WEBHOOK` | Update Webhook | Tool to update an existing webhook. Use when modifying webhook URL, events, or activation status after confirming the webhook ID. | | `BOTBABA_WA_GUPSHUP_EVENT_SIMULATOR` | Gupshup WhatsApp Webhook Event Simulator | Tool to simulate Gupshup WhatsApp webhook events. Use when testing BOTBABA_WA_GUPSHUP_MESSAGE dispatcher with different event types. | | `BOTBABA_WA_GUPSHUP_MESSAGE` | Forward Gupshup Webhook Message | Tool to forward inbound WhatsApp webhook events from Gupshup to Botbaba. Use when handling the POST callback from Gupshup's WhatsApp integration. | ## Supported Triggers None listed. ## Creating MCP Server - Stand-alone vs Composio SDK The Botbaba MCP server provides comprehensive access to Botbaba operations through Composio. Once connected, you can perform all major Botbaba actions directly from Codex using natural language commands. ## Complete Code None listed. ## Conclusion ### Conclusion You've successfully integrated Botbaba with Codex using Composio's MCP server. Now you can interact with Botbaba directly from your terminal, VS Code, or the Codex App using natural language commands. Key benefits of this setup: - Seamless integration across CLI, VS Code, and standalone app - Natural language commands for Botbaba operations - Managed authentication through Composio - Access to 20,000+ tools across 1000+ apps for cross-app workflows - CodeAct workbench for complex tool chaining Next steps: - Try asking Codex to perform various Botbaba operations - Explore cross-app workflows by connecting more toolkits - Build automation scripts that leverage Codex's AI capabilities ## How to build Botbaba MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/botbaba/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/botbaba/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/botbaba/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/botbaba/framework/claude-cowork) - [OpenClaw](https://composio.dev/toolkits/botbaba/framework/openclaw) - [Hermes](https://composio.dev/toolkits/botbaba/framework/hermes-agent) - [CLI](https://composio.dev/toolkits/botbaba/framework/cli) - [Google ADK](https://composio.dev/toolkits/botbaba/framework/google-adk) - [LangChain](https://composio.dev/toolkits/botbaba/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/botbaba/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/botbaba/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/botbaba/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/botbaba/framework/crew-ai) ## Related Toolkits - [Composio](https://composio.dev/toolkits/composio) - Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed. - [Composio search](https://composio.dev/toolkits/composio_search) - Composio search is a unified web search toolkit spanning travel, e-commerce, news, financial markets, images, and more. It lets you and your apps tap into up-to-date web data from a single, easy-to-integrate service. - [Perplexityai](https://composio.dev/toolkits/perplexityai) - Perplexityai delivers natural, conversational AI models for generating human-like text. Instantly get context-aware, high-quality responses for chat, search, or complex workflows. - [Browser tool](https://composio.dev/toolkits/browser_tool) - Browser tool is a virtual browser integration that lets AI agents interact with the web programmatically. It enables automated browsing, scraping, and action-taking from any AI workflow. - [Ai ml api](https://composio.dev/toolkits/ai_ml_api) - Ai ml api is a suite of AI/ML models for natural language and image tasks. It provides fast, scalable access to advanced AI capabilities for your apps and workflows. - [Aivoov](https://composio.dev/toolkits/aivoov) - Aivoov is an AI-powered text-to-speech platform offering 1,000+ voices in over 150 languages. Instantly turn written content into natural, human-like audio for any application. - [All images ai](https://composio.dev/toolkits/all_images_ai) - All-Images.ai is an AI-powered image generation and management platform. It helps you create, search, and organize images effortlessly with advanced AI capabilities. - [Anthropic administrator](https://composio.dev/toolkits/anthropic_administrator) - Anthropic administrator is an API for managing Anthropic organizational resources like members, workspaces, and API keys. It helps you automate admin tasks and streamline resource management across your Anthropic organization. - [Api labz](https://composio.dev/toolkits/api_labz) - Api labz is a platform offering a suite of AI-driven APIs and workflow tools. It helps developers automate tasks and build smarter, more efficient applications. - [Apipie ai](https://composio.dev/toolkits/apipie_ai) - Apipie ai is an AI model aggregator offering a single API for accessing top AI models from multiple providers. It helps developers build cost-efficient, latency-optimized AI solutions without juggling multiple integrations. - [Astica ai](https://composio.dev/toolkits/astica_ai) - Astica ai provides APIs for computer vision, NLP, and voice synthesis. Integrate advanced AI features into your app with a single API key. - [Bigml](https://composio.dev/toolkits/bigml) - BigML is a machine learning platform that lets you build, train, and deploy predictive models from your data. Its intuitive interface and robust API make machine learning accessible and efficient. - [Botpress](https://composio.dev/toolkits/botpress) - Botpress is an open-source platform for building, deploying, and managing chatbots. It helps teams automate conversations and deliver rich, interactive messaging experiences. - [Chatbotkit](https://composio.dev/toolkits/chatbotkit) - Chatbotkit is a platform for building and managing AI-powered chatbots using robust APIs and SDKs. It lets you easily add conversational AI to your apps for better user engagement. - [Cody](https://composio.dev/toolkits/cody) - Cody is an AI assistant built for businesses, trained on your company's knowledge and data. It delivers instant answers and insights, tailored for your team. - [Context7 MCP](https://composio.dev/toolkits/context7_mcp) - Context7 MCP delivers live, version-specific code docs and examples right from the source. It helps developers and AI agents instantly retrieve authoritative programming info—no more out-of-date docs. - [Customgpt](https://composio.dev/toolkits/customgpt) - CustomGPT.ai lets you build and deploy chatbots tailored to your own data and business needs. Get precise and context-aware AI conversations without writing code. - [Datarobot](https://composio.dev/toolkits/datarobot) - Datarobot is a machine learning platform that automates model development, deployment, and monitoring. It empowers organizations to quickly gain predictive insights from large datasets. - [Deepgram](https://composio.dev/toolkits/deepgram) - Deepgram is an AI-powered speech recognition platform for accurate audio transcription and understanding. It enables fast, scalable speech-to-text with advanced audio intelligence features. - [DeepImage](https://composio.dev/toolkits/deepimage) - DeepImage is an AI-powered image enhancer and upscaler. Get higher-quality images with just a few clicks. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Botbaba MCP? With a standalone Botbaba MCP server, the agents and LLMs can only access a fixed set of Botbaba tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Botbaba and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Codex? Yes, you can. Codex fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Botbaba tools. ### Can I manage the permissions and scopes for Botbaba while using Tool Router? Yes, absolutely. You can configure which Botbaba scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do. ### How safe is my data with Composio Tool Router? All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Botbaba data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)