Skip to main content
The Linear toolkit connects a Linear workspace to agents and workflows using a personal API key and lets you list and search issues, create and update issues and projects, manage labels and comments, inspect cycles and workflow states, and browse teams and users. The key inherits the creating user’s access and is not independently scoped.

​
Prerequisites

  • An active Linear workspace.
  • Permission in Linear to view the teams, issues, and projects the agent or workflow requires.
  • A Linear personal API key — go to Account → Security & access in Linear or visit linear.app/settings/api. Copy the key when it is displayed (keys start with lin_api_).
  • Prefer a dedicated, least-privilege automation user rather than a workspace administrator.
Linear personal API keys inherit the full permissions of the user who created them. Write actions (Create Issue, Update Issue, Create Project, Create Label, Add Comment) change live Linear data immediately and are not confirmation-gated. Use a dedicated service account with access limited to the teams the agent should use. Never expose keys in prompts, chat, tickets, screenshots, or documentation.

​
Setup

1

Create a Linear personal API key

In Linear, go to Account → Security & access and create a personal API key. Give it a recognizable label, choose the minimum permissions needed, and copy the key immediately.
2

Open an agent or workflow

Open an agent and add the Linear toolkit under Toolkits, or add a Linear step to a workflow.
3

Create a saved connection

In the Linear step, choose + New under Select saved connection. Enter a Connection Name and the Personal API Key. Save the connection.
4

Set a default team (agents only)

Optionally set a Default Team ID (a team key such as ENG or a unique ID) in the agent configuration. This is used when Create Issue or Create Project does not receive an explicit team.
5

Test the connection

Run Get Current User to confirm the key is linked to the intended Linear user. Then run List Teams to confirm workspace access before enabling write actions.

​
Available tools

​
Auth and Users

​
Teams

​
Issues

​
Projects

​
Labels

​
Comments

​
Cycles

​
Workflow

​
Use cases

  • List open issues for a team or assignee and summarize them before a standup.
  • Look up a specific issue by identifier (e.g. ENG-123), read its comments, and add a follow-up note.
  • Create an issue from a chat or form submission and assign it to the right team member.
  • Find the active cycle and inspect its issue progress and completion rate.
  • Update an issue’s state and assignee after a workflow step confirms a task is complete.

​
Troubleshooting