Flowly
Log inDownload
Docs/Integrations/Linear
Integrations

Linear

The linear tool lets the agent read and manage Linear issues, projects, teams, and comments through Linear's GraphQL API, authenticated with a personal API key.

Tool

ToolActions
linearlist_issues, get_issue, create_issue, update_issue, add_comment, search, list_projects, list_teams

Key params:

ParamUsed byNotes
issue_idget_issue, update_issue, add_commentUUID or key like ENG-123
titlecreate_issueIssue title
descriptioncreate_issue, update_issueMarkdown
team_idcreate_issue, list_issuesFilter / target team
project_idcreate_issue, list_issuesFilter / target project
assignee_idcreate_issue, update_issueUser ID to assign
state_nameupdate_issueWorkflow state name, e.g. In Progress, Done, Todo
prioritycreate_issue, update_issue0=none, 1=urgent, 2=high, 3=medium, 4=low
label_namescreate_issue, update_issueComma-separated label names
comment_bodyadd_commentComment text (markdown)
status_filterlist_issuesFilter by state name, e.g. Todo, In Progress
querysearchSearch query
max_resultslist/searchDefault 10

Configuration

The tool registers only when integrations.linear.apiKey is set:

{
  "integrations": {
    "linear": {
      "apiKey": "lin_api_..."
    }
  }
}

The key is sent as the Authorization header (raw token, no Bearer prefix) to Linear's GraphQL API.

Getting a Linear personal API key

In Linear, go to Settings β†’ API and create a personal API key. It is prefixed lin_api_. Paste it into integrations.linear.apiKey (or run setup below).

Setup

Run the interactive integrations setup and pick Linear:

flowly setup tools

This presents the Linear card, prompts for the API key, validates it with a probe, and writes integrations.linear.apiKey.

The integration requires a gateway restart to take effect (handled by setup, or run

flowly service restart).