# How to connect Heyy to Grok Bot ```json { "title": "How to connect Heyy to Grok Bot", "toolkit": "Heyy", "toolkit_slug": "heyy", "framework": "Grok Bot", "framework_slug": "grok-bot", "url": "https://composio.dev/toolkits/heyy/framework/grok-bot", "markdown_url": "https://composio.dev/toolkits/heyy/framework/grok-bot.md", "updated_at": "2026-10-04T16:10:14.694Z" } ``` ## Introduction Grok is xAI's assistant, and its bot builder lets you create a personal agent that holds context, runs skills, and connects to the apps you already use through plugins. This guide explains how to connect Heyy to a Grok bot using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a plugin, authenticate once, then ask your bot to work with Heyy in plain language. ## Also integrate Heyy with - [Claude Code](https://composio.dev/toolkits/heyy/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/heyy/framework/claude-cowork) - [OpenAI Agents SDK](https://composio.dev/toolkits/heyy/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/heyy/framework/claude-agents-sdk) - [Codex](https://composio.dev/toolkits/heyy/framework/codex) - [OpenClaw](https://composio.dev/toolkits/heyy/framework/openclaw) - [Hermes](https://composio.dev/toolkits/heyy/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/heyy/framework/atomic-agent) - [Google ADK](https://composio.dev/toolkits/heyy/framework/google-adk) - [LangChain](https://composio.dev/toolkits/heyy/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/heyy/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/heyy/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/heyy/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/heyy/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/heyy/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/heyy/framework/autogen) ## TL;DR Composio exposes 1,500+ apps to your Grok bot through a single connection, so you get: - Connect to 1,500+ apps with on-demand tool loading, so you do not fill your context window with unnecessary tool definitions. - Use programmatic tool calling through a remote workbench, letting the model write its own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls. - Handle large tool responses outside the model context to keep conversations lean. ## Connect Heyy to Grok Bot ### Connecting Heyy to Grok Bot Once Grok Bot is set up, you connect Heyy entirely from its interface, and the whole flow takes under a minute. ### Set up Grok Bot Get access. Grok Bot is included with Cursor Ultra, Cursor Premium Teams, and SuperGrok Heavy. Get the desktop app for macOS or Windows from [x.ai/bot](https://x.ai/bot) and sign in. An iPhone companion app is also available, and your bots sync across devices. Create a bot. Pick a suggested role or define your own, then give it a short name, one primary job, and a short description of how it should work. Focused bots work best, because a clear role gives the bot more useful context over time. ### Connect Heyy ### 1. Add the Composio plugin Click the button. The Composio listing on x.ai opens and launches Grok Bot for you. If the app does not open on its own, click Add to Grok Bot. [Add to Grok Bot](https://x.ai/bot/plugin/32661537) Grok Bot opens the Composio plugin, showing its connector and skills. Click Add. ### 2. Authenticate Go to the Installed section and click the Composio entry. You'll see its connector and skills listed. Click Authenticate. You'll be taken to the Composio consent screen. Review the access it requests and click Authorize. Composio handles the OAuth handshake for you, so you never touch API keys or tokens. ### 3. Connect your Heyy account Back in the chat, ask your bot to connect to Heyy or give it any Heyy task. For example, ask it to: - "Send promotional SMS to VIP customers" - "Reply to unread Instagram messages" - "Broadcast order updates on WhatsApp group" It will prompt you to authenticate and authorize access. That's it. Composio's tools are now available in your Grok bot, and your Heyy account is ready to use. ## What is Grok Bot? Grok is xAI's assistant, available as a chat interface and a bot builder for creating personal agents that run skills and connect to external apps. With Composio Connect, your Grok bot can securely access apps like Heyy through MCP without you sharing account credentials directly with the agent. ## What is the Heyy MCP server, and what's possible with it? The Heyy MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Heyy account. It provides structured and secure access to your contacts, channels, automations, message templates, labels, attributes, and webhooks, so your agent can create contacts, organize customer data, review messaging resources, manage webhooks, and inspect automations on your behalf. - Contact creation and organization: Have your agent create contacts with names, email addresses, phone numbers, labels, and custom details. - Labels and custom attributes: Let the agent create or remove labels and custom contact attributes to keep customer information organized. - Channel and automation discovery: Instruct your agent to list your available communication channels and review automation workflows for a selected channel. - Message template review: Direct your agent to retrieve available message templates for use across your customer communication workflows. - Webhook management: Have your agent list, create, update, activate, deactivate, or delete webhooks used for event notifications across channels. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `HEYY_CREATE_ATTRIBUTE` | Create Contact Attribute | Tool to create a new custom attribute for contacts in Heyy. Use when you need to add custom fields to track additional information about contacts, such as customer segments, preferences, or custom identifiers. | | `HEYY_CREATE_CONTACT` | Create Contact | Tool to create a new contact in Heyy with optional details including first name, last name, email, phone number, labels, and custom attributes. Use when you need to add a new contact to your Heyy account. | | `HEYY_CREATE_LABEL` | Create Label | Tool to create a new label for categorizing contacts in Heyy. Use when you need to organize contacts into categories or groups. | | `HEYY_CREATE_WEBHOOK` | Create Webhook | Tool to create a new webhook for receiving event notifications across multiple channels. Use when you need to set up real-time event notifications for messages. | | `HEYY_DELETE_ATTRIBUTE` | Delete Attribute | Tool to delete an attribute by its unique identifier. Use when you need to remove an attribute from the system. | | `HEYY_DELETE_LABEL` | Delete Label | Tool to delete a label by its unique identifier. Use when you need to remove a label from the system. | | `HEYY_DELETE_WEBHOOK` | Delete Webhook | Tool to delete a webhook by its unique identifier. Use when you need to remove a webhook from Heyy. | | `HEYY_LIST_ATTRIBUTES` | List Attributes | Tool to retrieve all attributes available in the Heyy system. Use when you need to get a list of all attributes with their properties and visibility settings. | | `HEYY_LIST_AUTOMATIONS` | List Automations | Tool to retrieve automation workflows for a specified channel. Use when you need to get all workflows configured for a channel. | | `HEYY_LIST_CHANNELS` | List Channels | Tool to retrieve all available channels from the Heyy system. Use when you need to get a complete list of channels with their details including name, type, status, and timestamps. | | `HEYY_LIST_MESSAGE_TEMPLATES` | List Message Templates | Tool to retrieve all message templates available in the Heyy system. Use when you need to view all existing templates for messaging. | | `HEYY_LIST_API_WEBHOOKS` | List API Webhooks | Tool to retrieve all API webhooks configured for the account. Use when you need to inspect or manage webhook configurations. | | `HEYY_UPDATE_WEBHOOK` | Update Webhook | Tool to update a webhook's URL and active status. Use when you need to modify an existing webhook's endpoint or enable/disable it. | ## Supported Triggers None listed. ## Creating MCP Server - Stand-alone vs Composio SDK Once connected, your Grok bot can access the Heyy MCP server through Composio to run the actions you authorize, using plain language in the chat. ## Complete Code None listed. ## Conclusion ### Way Forward Now that Heyy is connected, extend your setup by connecting the other apps you already use every day, so your Grok bot can run true cross-app workflows end to end. - Connect Calendar to turn threads into scheduled meetings automatically. - Connect Slack or Teams to post summaries, approvals, and alerts where your team works. - Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs. - Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps. Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, your bot can coordinate multiple tools safely and reliably in one conversation. ## How to build Heyy MCP Agent with another framework - [Claude Code](https://composio.dev/toolkits/heyy/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/heyy/framework/claude-cowork) - [OpenAI Agents SDK](https://composio.dev/toolkits/heyy/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/heyy/framework/claude-agents-sdk) - [Codex](https://composio.dev/toolkits/heyy/framework/codex) - [OpenClaw](https://composio.dev/toolkits/heyy/framework/openclaw) - [Hermes](https://composio.dev/toolkits/heyy/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/heyy/framework/atomic-agent) - [Google ADK](https://composio.dev/toolkits/heyy/framework/google-adk) - [LangChain](https://composio.dev/toolkits/heyy/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/heyy/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/heyy/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/heyy/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/heyy/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/heyy/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/heyy/framework/autogen) ## Related Toolkits - [Gmail](https://composio.dev/toolkits/gmail) - Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable. - [Outlook](https://composio.dev/toolkits/outlook) - Outlook is Microsoft's email and calendaring platform for unified communications and scheduling. It helps users stay organized with powerful email, contacts, and calendar management. - [Slack](https://composio.dev/toolkits/slack) - Slack is a channel-based messaging platform for teams and organizations. It helps people collaborate in real time, share files, and connect all their tools in one place. - [Gong](https://composio.dev/toolkits/gong) - Gong is a platform for video meetings, call recording, and team collaboration. It helps teams capture conversations, analyze calls, and turn insights into action. - [Microsoft teams](https://composio.dev/toolkits/microsoft_teams) - Microsoft Teams is a collaboration platform that combines chat, meetings, and file sharing within Microsoft 365. It keeps distributed teams connected and productive through seamless virtual communication. - [Slackbot](https://composio.dev/toolkits/slackbot) - Slackbot is a conversational automation tool for Slack that handles reminders, notifications, and automated responses. It boosts team productivity by streamlining onboarding, answering FAQs, and managing timely alerts—all right inside Slack. - [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing. - [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages. - [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections. - [2chat](https://composio.dev/toolkits/_2chat) - 2chat is an API platform for WhatsApp and multichannel text messaging. It streamlines chat automation, group management, and real-time messaging for developers. - [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach. - [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease. - [Adobe Marketing Agent MCP](https://composio.dev/toolkits/adobe_marketing_agent_mcp) - Adobe Marketing Agent MCP is Adobe's hosted MCP service that exposes marketing context, preferences, and agent capabilities. Use it to provide agents with campaign, audience, and analytics context via a managed integration. - [Aeroleads](https://composio.dev/toolkits/aeroleads) - Aeroleads is a B2B lead generation platform for finding business emails and phone numbers. Grow your sales pipeline faster with powerful prospecting tools. - [Agent mail](https://composio.dev/toolkits/agent_mail) - Agent mail provides AI agents with dedicated email inboxes for sending, receiving, and managing emails. It empowers agents to communicate autonomously with people, services, and other agents—no human intervention needed. - [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic. - [AimTell](https://composio.dev/toolkits/aimtell) - AimTell is a web push notification platform for managing websites, subscribers, campaigns, segments, and delivery analytics. Use it to send targeted browser notifications and measure engagement across your web push campaigns. - [Amcards](https://composio.dev/toolkits/amcards) - AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns. - [Android Texter](https://composio.dev/toolkits/android_texter) - Android Texter is an API service that connects Android phones to SMS, MMS, contacts, and device data. Use it to automate mobile messaging without building your own phone-to-API bridge. - [Autobound](https://composio.dev/toolkits/autobound) - Autobound is an AI-powered sales engagement platform that crafts hyper-personalized outreach and insights. It helps sales teams boost response rates and close more deals through tailored content and recommendations. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Heyy MCP? With a standalone Heyy MCP server, the agents and LLMs can only access a fixed set of Heyy tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Heyy and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Grok Bot? Yes, you can. Grok Bot 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 Heyy tools. ### Can I manage the permissions and scopes for Heyy while using Tool Router? Yes, absolutely. You can configure which Heyy 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 Heyy data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)