Can I use Linear as a CLI?

Yes. KosmoKrator exposes a Linear CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Linear through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Linear tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Linear credentials stored?

Linear credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Linear MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

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.

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.

Agent Surfaces

Linear CLIHeadless setup, JSON output, direct function calls. Linear MCPExpose selected tools to local MCP clients. Linear LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug: linear
route_slug: linear
package: linear
auth_strategy: api_key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true

Function Catalog

Function	Type	Parameters	Description
`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.