KosmoKrator

productivity

Linear MCP, CLI, and Lua Integration for AI Agents

Linear integration docs for AI agents: MCP gateway setup, Linear CLI commands, Lua API reference, credentials, and function schemas.

20 functions 11 read 9 write API key auth
Submit Linear feedback View package source

Linear for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata
integration_slug
linear
route_slug
linear
package
linear
auth_strategy
api_key API key
cli_setup_supported
true
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true
supports_multi_account
true

Quick Links

Lua APIAgent-facing namespace and function reference. Linear CLIHeadless setup and direct function calls. Linear MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Linear MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Linear.

Claude Code Linear MCP setup for Claude Code. Cursor Linear MCP setup for Cursor. Codex Linear MCP setup for Codex. OpenAI Agents Linear MCP setup for OpenAI Agents SDK. Claude Agent SDK Linear MCP setup for Claude Agent SDK. Vercel AI SDK Linear MCP setup for Vercel AI SDK. LangChain Linear MCP setup for LangChain. LangGraph Linear MCP setup for LangGraph. CrewAI Linear MCP setup for CrewAI. MCP clients Linear MCP setup for Generic MCP Clients.

Linear CLI Matrix

Use these pages for direct Linear CLI workflows in scripts, CI, cron, and agent wrappers.

CI Linear CLI for CI. Cron Jobs Linear CLI for cron jobs. Shell Scripts Linear CLI for shell scripts. Headless Automation Linear CLI for headless automation. Coding Agents Linear CLI for coding agents.

Function Catalog

FunctionTypeParametersDescription
linear.linear_create_issue Write write 7 Create a new issue in Linear. Requires a team ID and title. Optionally set description, priority (0=none, 1=urgent, 2=high, 3=medium, 4=low), assignee, labels, and initial state. Use linear_get_teams to find team IDs.
linear.linear_get_issue Read read 1 Get a single Linear issue by ID or identifier (e.g., "TEAM-123"). Returns full details including description, state, assignee, labels, team info, and comments.
linear.linear_update_issue Write write 7 Update an existing Linear issue. Provide the issue ID or identifier and any fields to change. Only specified fields will be updated. Priority: 0=none, 1=urgent, 2=high, 3=medium, 4=low.
linear.linear_search_issues Read read 6 Search Linear issues using filter criteria. Supports filtering by text query, team, state name, assignee, and priority. Returns matching issues with pagination info.
linear.linear_list_issues Read read 5 List issues for a specific Linear team. Supports filtering by status, assignee, and cursor-based pagination. Use linear_get_teams to find team IDs.
linear.linear_delete_issue Write write 1 Delete a Linear issue by ID or identifier. This action is irreversible.
linear.linear_create_comment Write write 2 Add a comment to a Linear issue. Supports markdown formatting. Provide the issue ID or identifier and the comment body.
linear.linear_list_comments Read read 1 List all comments on a Linear issue, ordered chronologically. Provide the issue ID or identifier.
linear.linear_get_teams Read read 0 Get all Linear teams the authenticated user has access to, including team name, key, description, and member list. Use this to discover team IDs needed for other tools.
linear.linear_list_projects Read read 2 List Linear projects with optional cursor-based pagination. Returns project details including state, dates, lead, and associated teams.
linear.linear_create_project Write write 4 Create a new Linear project. Requires a name and at least one team ID. Optionally set description, lead, and target dates. Use linear_get_teams to find team IDs.
linear.linear_update_project Write write 4 Update a Linear project. Provide the project ID and any fields to change. Only specified fields will be updated.
linear.linear_list_initiatives Read read 1 List Linear initiatives with optional limit. Returns initiative details including state, dates, and associated projects.
linear.linear_create_initiative Write write 2 Create a new Linear initiative. Initiatives group related projects together. Requires a name. Optionally include a description.
linear.linear_list_labels Read read 1 List issue labels in Linear. Optionally filter by team. Returns label ID, name, color, and description.
linear.linear_add_label Write write 2 Add a label to a Linear issue. Provide the issue ID or identifier and the label ID to add. The label will be appended to existing labels. Use linear_list_labels to find label IDs.
linear.linear_remove_label Write write 2 Remove a label from a Linear issue. Provide the issue ID or identifier and the label ID to remove. Other labels on the issue are preserved.
linear.linear_get_current_user Read read 0 Get the currently authenticated Linear user's profile, including ID, name, email, and avatar URL.
linear.linear_list_workflows Read read 1 List workflow states for a Linear team. Shows all available statuses (e.g., Backlog, Todo, In Progress, Done) with their IDs, types, and colors. Optionally filter by team ID.
linear.linear_raw_query Read read 2 Execute an arbitrary GraphQL query or mutation against the Linear API. Provide a GraphQL document and optional variables as JSON. Use this for advanced operations not covered by other tools.