How-Tos
How to connect Linear to Grok Bot with Composio
Add Composio to a Grok Bot, authorize, and call Linear tools for issues, comments, and cycles without repeating bot setup.
Searcher → Analyst → Writer → Editor · subagentic-20260916-0800
If the Grok Bot already exists, Linear wiring is a plugin-and-OAuth path—not another account-setup guide. You add Composio in Plugins, authorize on the consent screen, then prompt the bot to connect Linear or run a Linear task so OAuth finishes. After that, issues, comments, and cycles are natural-language work.
Grok is xAI’s assistant. Its bot builder holds context, runs skills, and reaches apps through plugins. Composio Connect is the plugin that talks to Linear: it handles OAuth, token refresh, and reliability so you do not manage keys yourself. Linear on the toolkit page is the issue-tracking product, with OAuth2 and API key options, managed auth, 32 tools, and 3 triggers.
Once Grok Bot is set up, you connect Linear entirely from its interface. The vendor page says the whole flow takes under a minute.
Add Composio from Plugins
Open the Grok bot you want on Linear, then click Plugins in the left sidebar to open the plugin marketplace.
Type Composio into the Search plugins box and click Add on the Composio result. It then shows under 1 installed at the top of the marketplace.
Go to the Installed section and click the Composio entry. You will see its connector and skills listed (for example, 1 connector, 2 skills).
Click Authenticate. You land on the Composio consent screen. Review the access it requests and click Authorize. Composio runs the OAuth handshake, so you never touch API keys or tokens.
That step authorizes Composio. Linear still needs its own account connection, which happens from chat—not from another marketplace click.
Complete Linear OAuth with a task
Back in the chat, ask the bot to connect to Linear or give it any Linear task. The official examples:
- "Create a new bug for team Mobile"
- "Add a comment to issue LIN-123"
- "List all cycles for the Design team"
The bot will prompt you to authenticate and authorize access. After that, Composio’s tools are available in the Grok bot and the Linear account is ready to use. You authenticate once, then work in plain language.
What Linear MCP actually exposes
The Linear MCP server is an implementation of the Model Context Protocol that connects an agent to a Linear account. It gives structured access to issues, projects, and workflows so the agent can create issues, post comments, manage attachments, organize teams, and automate project tracking.
The page groups that work as automated issue creation and management (create, update, or archive issues), commenting and collaboration, attachment handling, team and cycle insights (teams, cycles by team ID, default issue parameters), and personalized workspace access (current user and profile).
Trigger names are not listed on the page. The 32 tools are.
Issues. Create linear issue creates a new issue in a specified Linear project and team, requiring a team identifier and title, and allowing optional properties like description, assignee, state, priority, cycle, and due date. Get Linear issue retrieves comprehensive details for an existing issue. List Linear issues lists non-archived issues; if a project is not specified, issues from all accessible projects are returned. List issues by team ID scopes that list to a team. List issue drafts lists drafts. Search Linear issues runs full-text search across identifier, title, and description. Update issue updates an existing Linear issue using its identifier; it requires at least one other attribute for modification. Delete issue archives an issue by ID—Linear’s standard delete—and is idempotent. Get create issue default params fetches a team’s default estimate and state for pre-filling forms.
Comments and reactions. Create a comment posts on a specified issue. Update a comment changes an existing comment’s body. Add reaction to comment and Remove reaction from comment target an existing comment.
Projects and planning. Create Project creates a project with a name and team associations. Get Linear project and List linear projects fetch one or all. Update Project updates an existing project. Create Project Milestone takes a name and optional target date and sort order. Create Project Update posts a project status update.
Cycles, teams, labels, people. Get cycles by team ID retrieves cycles for a team—time-boxed periods like sprints. Get all cycles is org-wide with no filters. Get teams retrieves teams with members and projects. Get labels and Create a label cover categorization; Remove label from Linear issue is successful even if the label is not on the issue. List Linear states retrieves workflow states for a team. List Linear users lists workspace users (not team-scoped) with IDs, names, emails, and active status. Get current user returns the authenticated account’s ID, name, email, and profile—which may be a bot or service account, not a human.
Attachments, relations, and GraphQL. Create attachment associates a new attachment with an existing issue. Download issue attachments downloads a specific attachment from a Linear issue; the file name must include the correct file extension. Create issue relation uses the issueRelationCreate mutation. Run Query or Mutation executes any GraphQL query or mutation against Linear’s API.
Tool Router versus a fixed Linear MCP
With a standalone Linear MCP server, agents only get a fixed set of Linear tools tied to that server. With Composio Tool Router, agents can dynamically load tools from Linear and other apps through a single MCP endpoint, based on the task.
Grok Bot fully supports MCP integration: structured tool calling, message history handling, and model orchestration, while Tool Router discovers and serves the right Linear tools.
You can configure which Linear scopes and actions are allowed when connecting the account. You can also bring your own OAuth credentials or API configuration so you keep control over what the agent can do.
On handling of credentials, the page states that tokens, keys, and configuration are encrypted at rest and in transit, and that Composio is SOC 2 Type 2 compliant.
Open the existing bot, add Composio from Plugins, click Authorize on the consent screen, then send one of the three example prompts against a real Linear team so OAuth completes. For the numbered plugin steps and the full tool catalog, read Composio’s Linear for Grok Bot page.