Linear integration

Connect Linear to let Agents create and manage issues, search projects, and add comments. Linear is available as a set of Agent tools, not as Flow steps.

Setting up Linear

Linear tools are connected per Agent through the tool picker, not from a central Settings page.

  1. Create a personal API key in Linear Settings → API.
  2. In the Agent editor, add a tool from the tool picker and choose Linear.
  3. Paste your API key (it starts with lin_api_) into the setup form and save.

The API key is stored with that Agent’s tool configuration.

Available tools

Once connected, the following tools are available to Agents:

  • create_issue — Create a new issue (with team, priority, labels, project, and estimate)
  • update_issue — Update an existing issue
  • search_issues — Search for issues with team, assignee, and state filters
  • get_issue — Get details of a specific issue by ID or identifier (e.g., “ENG-123”)
  • list_teams — List all teams in the workspace
  • list_projects — List projects, optionally filtered by team
  • add_comment — Add a comment to an issue

Enable these tools when configuring an Agent.

Use cases

  • Bug reporting: Auto-create issues from customer feedback
  • Feature requests: Track requests from chat interactions
  • Escalations: Create urgent issues when AI detects problems
  • Monitoring: Log anomalies detected by scheduled Agents

Removing Linear access

Linear credentials live with each Agent’s tool configuration, not in a central Settings panel. To remove access, remove the Linear tools from the Agent (or replace the API key). Revoke the key from your Linear settings if it is no longer needed.

Next steps