1. Docs
2. /
3. Tool reference
4. /
5. Linear
6. /
7. createLinearIssue

Linear

createLinearIssue

Create Linear Issue

Create a Linear issue in a team as the member's own Linear user, with a title and optionally a description, state, assignee, priority, labels and project.

writeexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "file a Linear issue for this", and it calls createLinearIssue.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "teamId": "<teamId>",
    "title": "<title>"
  },
  "name": "createLinearIssue"
}

Arguments

• assigneeIdstringoptional"me" for the key's own Linear user, or a member id from listLinearTeams.
• descriptionstringoptionalIssue description in markdown, at most 50000 characters.
• labelIdsstring[]optionalLabel ids from listLinearTeams. REPLACES the issue's whole label set.
• prioritynumberoptional0 none, 1 urgent, 2 high, 3 medium, 4 low.
• projectIdstringoptionalProject id from listLinearProjects.
• stateIdstringoptionalWorkflow state id from listLinearTeams for the issue's team.
• teamIdstringrequiredLinear team id from listLinearTeams.
• titlestringrequiredIssue title, at most 255 characters.

Returns

Returns the new issue with its identifier and url.

Declared limits

• labelIds: maximum items 25

Ask for it

The Cloud routes these requests to this verb.

• file a Linear issue for this
• add a bug to ENG

Pair it with

The verbs that finish the job.

• listLinearTeams
• updateLinearIssue
• commentOnLinearIssue

Questions

• What does createLinearIssue do?

  Create a Linear issue in a team as the member's own Linear user, with a title and optionally a description, state, assignee, priority, labels and project. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use createLinearIssue from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "file a Linear issue for this", and it calls createLinearIssue.

• Is createLinearIssue safe to let an AI call?

  createLinearIssue changes your workspace. What an AI creates is Private until you share it. It reaches a system outside The Cloud on your behalf.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.