Linear Automation via Rube MCP
Automate Linear operations through Composio's Linear toolkit via Rube MCP.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Linear connection via
RUBE_MANAGE_CONNECTIONS with toolkit linear
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit linear
- If connection is not ACTIVE, follow the returned auth link to complete Linear OAuth
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Manage Issues
When to use: User wants to create, search, update, or list Linear issues
Tool sequence:
LINEAR_GET_ALL_LINEAR_TEAMS - Get team IDs [Prerequisite]LINEAR_LIST_LINEAR_STATES - Get workflow states for a team [Prerequisite]LINEAR_CREATE_LINEAR_ISSUE - Create a new issue [Optional]LINEAR_SEARCH_ISSUES / LINEAR_LIST_LINEAR_ISSUES - Find issues [Optional]LINEAR_GET_LINEAR_ISSUE - Get issue details [Optional]LINEAR_UPDATE_ISSUE - Update issue properties [Optional]
Key parameters:
team_id: Team ID (required for creation)title: Issue titledescription: Issue description (Markdown supported)state_id: Workflow state IDassignee_id: Assignee user IDpriority: 0 (none), 1 (urgent), 2 (high), 3 (medium), 4 (low)label_ids: Array of label IDs
Pitfalls:
- Team ID is required when creating issues; use GET_ALL_LINEAR_TEAMS first
- State IDs are team-specific; use LIST_LINEAR_STATES with the correct team
- Priority uses integer values 0-4, not string names
2. Manage Projects
When to use: User wants to create or update Linear projects
Tool sequence:
LINEAR_LIST_LINEAR_PROJECTS - List existing projects [Optional]LINEAR_CREATE_LINEAR_PROJECT - Create a new project [Optional]LINEAR_UPDATE_LINEAR_PROJECT - Update project details [Optional]
Key parameters:
name: Project namedescription: Project descriptionteam_ids: Array of team IDs associated with the projectstate: Project state (e.g., 'planned', 'started', 'completed')
Pitfalls:
- Projects span teams; they can be associated with multiple teams
3. Manage Cycles
When to use: User wants to work with Linear cycles (sprints)
Tool sequence:
LINEAR_GET_ALL_LINEAR_TEAMS - Get team ID [Prerequisite]LINEAR_GET_CYCLES_BY_TEAM_ID / LINEAR_LIST_LINEAR_CYCLES - List cycles [Required]
Key parameters:
team_id: Team ID for cycle operationsnumber: Cycle number
Pitfalls:
- Cycles are team-specific; always scope by team_id
4. Manage Labels and Comments
When to use: User wants to create labels or comment on issues
Tool sequence:
LINEAR_CREATE_LINEAR_LABEL - Create a new label [Optional]LINEAR_CREATE_LINEAR_COMMENT - Comment on an issue [Optional]LINEAR_UPDATE_LINEAR_COMMENT - Edit a comment [Optional]
Key parameters:
name: Label namecolor: Label color (hex)issue_id: Issue ID for commentsbody: Comment body (Markdown)
Pitfalls:
- Labels can be team-scoped or workspace-scoped
- Comment body supports Markdown formatting
5. Custom GraphQL Queries
When to use: User needs advanced queries not covered by standard tools
Tool sequence:
LINEAR_RUN_QUERY_OR_MUTATION - Execute custom GraphQL [Required]
Key parameters:
query: GraphQL query or mutation stringvariables: Variables for the query
Pitfalls:
- Requires knowledge of Linear's GraphQL schema
- Rate limits apply to GraphQL queries
Common Patterns
ID Resolution
Team name -> Team ID:
1. Call LINEAR_GET_ALL_LINEAR_TEAMS
2. Find team by name in response
3. Extract id field
State name -> State ID:
1. Call LINEAR_LIST_LINEAR_STATES with team_id
2. Find state by name
3. Extract id field
Pagination
- Linear tools return paginated results
- Check for pagination cursors in responses
- Pass cursor to next request for additional pages
Known Pitfalls
Team Scoping:
- Issues, states, and cycles are team-specific
- Always resolve team_id before creating issues
Priority Values:
- 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low
- Use integer values, not string names
Quick Reference
| Task |
Tool Slug |
Key Params |
| List teams |
LINEAR_GET_ALL_LINEAR_TEAMS |
(none) |
| Create issue |
LINEAR_CREATE_LINEAR_ISSUE |
team_id, title, description |
| Search issues |
LINEAR_SEARCH_ISSUES |
query |
| List issues |
LINEAR_LIST_LINEAR_ISSUES |
team_id, filters |
| Get issue |
LINEAR_GET_LINEAR_ISSUE |
issue_id |
| Update issue |
LINEAR_UPDATE_ISSUE |
issue_id, fields |
| List states |
LINEAR_LIST_LINEAR_STATES |
team_id |
| List projects |
LINEAR_LIST_LINEAR_PROJECTS |
(none) |
| Create project |
LINEAR_CREATE_LINEAR_PROJECT |
name, team_ids |
| Update project |
LINEAR_UPDATE_LINEAR_PROJECT |
project_id, fields |
| List cycles |
LINEAR_LIST_LINEAR_CYCLES |
team_id |
| Get cycles |
LINEAR_GET_CYCLES_BY_TEAM_ID |
team_id |
| Create label |
LINEAR_CREATE_LINEAR_LABEL |
name, color |
| Create comment |
LINEAR_CREATE_LINEAR_COMMENT |
issue_id, body |
| Update comment |
LINEAR_UPDATE_LINEAR_COMMENT |
comment_id, body |
| List users |
LINEAR_LIST_LINEAR_USERS |
(none) |
| Current user |
LINEAR_GET_CURRENT_USER |
(none) |
| Run GraphQL |
LINEAR_RUN_QUERY_OR_MUTATION |
query, variables |
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
1---2name: linear-automation3description: Automate Linear tasks via Rube MCP (Composio): issues, projects, cycles, teams, labels. Always search tools first for current schemas.4license: MIT5---6# Linear Automation via Rube MCP78Automate Linear operations through Composio's Linear toolkit via Rube MCP.910## Prerequisites1112- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)13- Active Linear connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `linear`14- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas1516## Setup1718**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.1920211. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds222. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `linear`233. If connection is not ACTIVE, follow the returned auth link to complete Linear OAuth244. Confirm connection status shows ACTIVE before running any workflows2526## Core Workflows2728### 1. Manage Issues2930**When to use**: User wants to create, search, update, or list Linear issues3132**Tool sequence**:331. `LINEAR_GET_ALL_LINEAR_TEAMS` - Get team IDs [Prerequisite]342. `LINEAR_LIST_LINEAR_STATES` - Get workflow states for a team [Prerequisite]353. `LINEAR_CREATE_LINEAR_ISSUE` - Create a new issue [Optional]364. `LINEAR_SEARCH_ISSUES` / `LINEAR_LIST_LINEAR_ISSUES` - Find issues [Optional]375. `LINEAR_GET_LINEAR_ISSUE` - Get issue details [Optional]386. `LINEAR_UPDATE_ISSUE` - Update issue properties [Optional]3940**Key parameters**:41- `team_id`: Team ID (required for creation)42- `title`: Issue title43- `description`: Issue description (Markdown supported)44- `state_id`: Workflow state ID45- `assignee_id`: Assignee user ID46- `priority`: 0 (none), 1 (urgent), 2 (high), 3 (medium), 4 (low)47- `label_ids`: Array of label IDs4849**Pitfalls**:50- Team ID is required when creating issues; use GET_ALL_LINEAR_TEAMS first51- State IDs are team-specific; use LIST_LINEAR_STATES with the correct team52- Priority uses integer values 0-4, not string names5354### 2. Manage Projects5556**When to use**: User wants to create or update Linear projects5758**Tool sequence**:591. `LINEAR_LIST_LINEAR_PROJECTS` - List existing projects [Optional]602. `LINEAR_CREATE_LINEAR_PROJECT` - Create a new project [Optional]613. `LINEAR_UPDATE_LINEAR_PROJECT` - Update project details [Optional]6263**Key parameters**:64- `name`: Project name65- `description`: Project description66- `team_ids`: Array of team IDs associated with the project67- `state`: Project state (e.g., 'planned', 'started', 'completed')6869**Pitfalls**:70- Projects span teams; they can be associated with multiple teams7172### 3. Manage Cycles7374**When to use**: User wants to work with Linear cycles (sprints)7576**Tool sequence**:771. `LINEAR_GET_ALL_LINEAR_TEAMS` - Get team ID [Prerequisite]782. `LINEAR_GET_CYCLES_BY_TEAM_ID` / `LINEAR_LIST_LINEAR_CYCLES` - List cycles [Required]7980**Key parameters**:81- `team_id`: Team ID for cycle operations82- `number`: Cycle number8384**Pitfalls**:85- Cycles are team-specific; always scope by team_id8687### 4. Manage Labels and Comments8889**When to use**: User wants to create labels or comment on issues9091**Tool sequence**:921. `LINEAR_CREATE_LINEAR_LABEL` - Create a new label [Optional]932. `LINEAR_CREATE_LINEAR_COMMENT` - Comment on an issue [Optional]943. `LINEAR_UPDATE_LINEAR_COMMENT` - Edit a comment [Optional]9596**Key parameters**:97- `name`: Label name98- `color`: Label color (hex)99- `issue_id`: Issue ID for comments100- `body`: Comment body (Markdown)101102**Pitfalls**:103- Labels can be team-scoped or workspace-scoped104- Comment body supports Markdown formatting105106### 5. Custom GraphQL Queries107108**When to use**: User needs advanced queries not covered by standard tools109110**Tool sequence**:1111. `LINEAR_RUN_QUERY_OR_MUTATION` - Execute custom GraphQL [Required]112113**Key parameters**:114- `query`: GraphQL query or mutation string115- `variables`: Variables for the query116117**Pitfalls**:118- Requires knowledge of Linear's GraphQL schema119- Rate limits apply to GraphQL queries120121## Common Patterns122123### ID Resolution124125**Team name -> Team ID**:126```1271. Call LINEAR_GET_ALL_LINEAR_TEAMS1282. Find team by name in response1293. Extract id field130```131132**State name -> State ID**:133```1341. Call LINEAR_LIST_LINEAR_STATES with team_id1352. Find state by name1363. Extract id field137```138139### Pagination140141- Linear tools return paginated results142- Check for pagination cursors in responses143- Pass cursor to next request for additional pages144145## Known Pitfalls146147**Team Scoping**:148- Issues, states, and cycles are team-specific149- Always resolve team_id before creating issues150151**Priority Values**:152- 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low153- Use integer values, not string names154155## Quick Reference156157| Task | Tool Slug | Key Params |158|------|-----------|------------|159| List teams | LINEAR_GET_ALL_LINEAR_TEAMS | (none) |160| Create issue | LINEAR_CREATE_LINEAR_ISSUE | team_id, title, description |161| Search issues | LINEAR_SEARCH_ISSUES | query |162| List issues | LINEAR_LIST_LINEAR_ISSUES | team_id, filters |163| Get issue | LINEAR_GET_LINEAR_ISSUE | issue_id |164| Update issue | LINEAR_UPDATE_ISSUE | issue_id, fields |165| List states | LINEAR_LIST_LINEAR_STATES | team_id |166| List projects | LINEAR_LIST_LINEAR_PROJECTS | (none) |167| Create project | LINEAR_CREATE_LINEAR_PROJECT | name, team_ids |168| Update project | LINEAR_UPDATE_LINEAR_PROJECT | project_id, fields |169| List cycles | LINEAR_LIST_LINEAR_CYCLES | team_id |170| Get cycles | LINEAR_GET_CYCLES_BY_TEAM_ID | team_id |171| Create label | LINEAR_CREATE_LINEAR_LABEL | name, color |172| Create comment | LINEAR_CREATE_LINEAR_COMMENT | issue_id, body |173| Update comment | LINEAR_UPDATE_LINEAR_COMMENT | comment_id, body |174| List users | LINEAR_LIST_LINEAR_USERS | (none) |175| Current user | LINEAR_GET_CURRENT_USER | (none) |176| Run GraphQL | LINEAR_RUN_QUERY_OR_MUTATION | query, variables |177178## When to Use179This skill is applicable to execute the workflow or actions described in the overview.180181## Limitations182- Use this skill only when the task clearly matches the scope described above.183- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.184- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
JantonioFC