How to connect Linq to Grok Bot

Connect Grok Bot to Linq MCP. Send an sms to a customer, review recent rcs conversation messages, and more using natural language, with authentication handled for you.

Linq logoLinq
Api Key

Linq is a communications API for sending and managing iMessage, RCS, and SMS conversations. It also supports attachments, phone numbers, payments, and webhooks in one platform.

68 Tools

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 Linq 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 Linq in plain language.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Linq with

Why use Composio?

Composio exposes 1,700+ apps to your Grok bot through a single connection, so you get:

  • Connect to 1,700+ 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.

Connecting Linq to Grok Bot

Once Grok Bot is set up, you connect Linq 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 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 Linq

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

Composio for Grok Bot listing on x.ai with the Add to Grok Bot button

Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.

Composio plugin sheet in Grok Bot with the Add button

2. Authenticate

Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.

Installed Composio plugin showing the Authenticate button

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.

Composio authorization screen with Authorize and Deny

3. Connect your Linq account

Back in the chat, ask your bot to connect to Linq or give it any Linq task.

For example, ask it to:

  • "Send an SMS to a customer"
  • "Review recent RCS conversation messages"
  • "Create a payment link for customer"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in your Grok bot, and your Linq 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 Linq through MCP without you sharing account credentials directly with the agent.

What is the Linq MCP server, and what's possible with it?

The Linq MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Linq account. It provides structured and secure access to messaging, chats, phone numbers, polls, payments, and webhook subscriptions, so your agent can send messages, manage conversations, check messaging and delivery details, handle payments, and configure event notifications on your behalf.

  • iMessage, RCS, and SMS conversations: Have your agent check a recipient’s messaging capability, create chats, send initial messages, view conversations, edit recent messages, and delete messages.
  • Chat and contact management: Let the agent list chats, inspect participants and shared locations, add people to group chats, leave group chats, and manage blocked phone numbers or email addresses.
  • Polls and message threads: Direct your agent to create iMessage polls, add poll options, review responses, and retrieve threaded replies.
  • Payments and payment requests: Instruct your agent to create, review, cancel, and reconcile payments or customer-facing payment requests, including checking payment handle connections and provider status.
  • Phone lines and webhooks: Have your agent list sending numbers, find an available number, review contact-card details, and create, inspect, or remove webhook subscriptions for Linq events.

Way Forward

Now that Linq 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.

TOOLS

Supported Tools

Every Linq action and event your agent gets out of the box.

Add Chat Participant

Add an external participant to an existing group chat.

Add Poll Options

Irreversibly add recipient-visible options to an existing iMessage poll.

Block Handle

Block a handle account-wide from inbound and direct outbound messaging.

Cancel Payment

Irreversibly cancel a financial payment and close its virtual card.

Cancel Payment Request

Irreversibly cancel an unpaid payment request and its underlying payment intent.

Check Messaging Capability

Check whether a recipient can receive iMessage or RCS without sending a message.

Connect Payment Handle

Start the financial-consent ceremony for a customer phone number or email so an agent can later pay on that customer's behalf.

Create Chat

Create or reuse a chat on an explicit sending line and send an irreversible recipient-visible initial message.

Create Payment

Create or advance a real financial payment on a connected customer's behalf, potentially minting a single-use virtual card.

Create Payment Request

Create a customer-facing checkout that can collect a one-time charge or start an auto-renewing subscription.

Create Poll

Irreversibly send a recipient-visible iMessage poll to an existing chat.

Create Webhook Subscription

Create a webhook subscription for selected Linq events at a controlled HTTPS callback.

Delete Attachment

Permanently delete a Linq attachment and its stored bytes.

Delete Message

Irreversibly delete a message record from Linq.

Delete Webhook Subscription

Permanently delete a Linq webhook subscription and stop its future event deliveries.

Edit Message

Irreversibly change recipient-visible text in one part of a message sent within the last 15 minutes; Linq permits at most five edits per message.

Get Attachment

Return metadata and current status for a Linq attachment referenced by a message.

Get Available Number

Select an available Linq sending number, optionally for recipients or a line type.

Get Chat

Return one chat by ID, including participants, service, state, and health information.

Get Chat Location

Return precise locations currently shared by contacts in a chat.

Get Experience

Return one Linq experience and preserve its dynamic action field definitions.

Get Message

Return one Linq message by ID with its content parts, sender, actual and preferred transport, delivery state, reply target, and timestamps.

Get Payment

Read a payment's financial state, amount, customer handle, merchant details, and any customer-action URL.

Get Payment Credentials

Return the complete, highly sensitive short-lived handoff used to reveal a ready payment's virtual card directly from the provider.

Get Payment Handle Connection

Read the financial-consent connection status for a customer phone number or email.

Get Payment Provider

Read the organization's onboarding status for a payment provider.

Get Payment Request

Return one payment request's amount, lifecycle status, checkout details, and provider join keys.

Get Poll

Return an iMessage poll's current options, voters, and distinct voter count.

Get Reputation Audit

Return a Linq line reputation audit created with explicit approval.

Get Webhook Subscription

Return one Linq webhook subscription by ID, including its callback URL, event and phone filters, active state, and configured routing-header names.

Leave Chat

Leave an iMessage group chat.

List Blocked Handles

Return phone numbers, email addresses, short codes, and sender IDs currently blocked account-wide from inbound and direct outbound messaging.

List Chats

Return one page of chats, optionally filtered by sending line or participant, with a cursor for the next page.

List Contact Cards

Return Linq account contact-card identity data, optionally for one E.164 sending line.

List Experiences

Discover Linq experiences and their dynamic action fields.

List Messages

Return one page of messages from a chat, including content, sender, transport, delivery state, direction, reply target, and timestamps, plus a cursor for older messages.

List Message Thread

Return one page containing the origin message and threaded replies, starting from any message in the thread.

List Payment Requests

Return one newest-first page of payment requests for reconciliation, optionally filtered by lifecycle status.

List Phone Numbers

Return the connected Linq account's sending lines with line type, forwarding configuration, and reputation status.

List Webhook Events

Return the webhook event types currently available for subscription on the connected Linq account.

List Webhook Subscriptions

Return the connected Linq account's webhook subscriptions, including event and phone-number filters, target URLs, active state, and routing-header names.

Mark Chat As Read

Mark every message in a chat as read and send an irreversible read receipt.

Remove Chat Background

Reset a chat's recipient-visible transcript background to the default.

Remove Chat Participant

Queue removal of an external participant from a group chat.

Request Attachment Upload

Reserve persistent attachment storage and return a 15-minute presigned upload URL.

Request Chat Location

Prompt a contact in a one-to-one iMessage chat to consent to sharing their precise location.

Revoke Payment Handle Connection

Irreversibly revoke this partner's financial-consent grant for a customer phone number or email.

Send Message

Send one irreversible, externally visible message to phone numbers or emails.

Send Message to Chat

Send one follow-up or threaded reply to an existing Linq chat using its established sending line.

Send Voice Memo to Chat

Irreversibly send recipient-visible audio as a native iMessage voice memo bubble to every participant in an existing Linq chat.

Set Chat Background

Set a recipient-visible color, animated, or photo transcript background.

Set Up Contact Card

Create or replace a Linq contact card for a sending line.

Share Contact Card With Chat

Share the connected sending line's active contact card with a chat.

Start Payment Provider Onboarding

Create a hosted payment-provider onboarding session for the organization.

Start Reputation Audit

Start a potentially metered or limited reputation audit for a Linq sending line.

Start Typing Indicator

Show a best-effort recipient-visible typing indicator for about 85-90 seconds.

Stop Chat Location Sharing

Stop a specific contact's inbound location share.

Stop Typing Indicator

Immediately clear the connected line's recipient-visible typing indicator for a chat.

Toggle Poll Vote

Irreversibly send a recipient-visible update that adds or removes the connected line's vote on one option of an iMessage poll.

Unblock Handle

Remove an account-wide messaging block.

Update Chat

Update a group chat's display name or icon.

Update Contact Card

Update the public contact-card identity for one Linq sending line.

Update iMessage App Card

Irreversibly send a recipient-visible in-place update to an iMessage app card.

Update Message Reaction

Irreversibly mutate recipient-visible reaction state by adding or removing a tapback, or by adding an iMessage sticker.

Update Phone Number

Change a Linq sending line's production forwarding configuration.

Update Sticker Placement

Irreversibly send a recipient-visible update that moves, resizes, or rotates an existing iMessage sticker on a message.

Update Webhook Subscription

Update a Linq webhook subscription's callback, filters, active state, or routing-header names.

Verify Payment Handle

Submit a customer's single-use OTP to complete the financial-consent ceremony and authorize future payments on the customer's behalf.

FAQ

Frequently asked questions

Start with Linq.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Linq tool your agent needs.Free to start.

Start building