Linear MCP server for AI agents

Search, create and update Linear issues, comments, projects and workflow states.

Auth
OAuth 2.0 (sign in with the app) · API key
Tools
11
Triggers
0
Category
Project management, Developer tools
Connect Linear linear.app

Tools and triggers

  • List teams

    LINEAR_LIST_TEAMS

    Lists the teams in the workspace with their ids and keys (the `ENG` in `ENG-123`).read-only

  • List issues

    LINEAR_LIST_ISSUES

    Lists issues, newest activity first. Filter by team, workflow state or assignee; use `assignee_id` `me` for the connected user.read-only

  • Get an issue

    LINEAR_GET_ISSUE

    Returns one issue with its description, state, assignee, labels and recent comments.read-only

  • Search issues

    LINEAR_SEARCH_ISSUES

    Full-text search over issue titles and descriptions.read-only

  • Create an issue

    LINEAR_CREATE_ISSUE

    Creates an issue in a team. Priority is 0 (none), 1 (urgent), 2 (high), 3 (medium) or 4 (low).

  • Update an issue

    LINEAR_UPDATE_ISSUE

    Changes an issue's title, description, state, assignee, priority, project, labels or due date. To close it, set `state_id` to a completed state.destructive

  • Add a comment

    LINEAR_CREATE_COMMENT

    Comments on an issue.

  • List projects

    LINEAR_LIST_PROJECTS

    Lists projects with their state, progress and target date.read-only

  • List workflow states

    LINEAR_LIST_WORKFLOW_STATES

    Lists workflow states (Backlog, Todo, In Progress, Done, …) with their ids. Needed to move an issue between states.read-only

  • List labels

    LINEAR_LIST_LABELS

    Lists issue labels with their ids.read-only

  • List users

    LINEAR_LIST_USERS

    Lists the members of the workspace with their ids and emails.read-only

Connect via MCP

Create an MCP server for Linear in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.

terminal
claude mcp add --transport http linear \
  "https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
  --header "x-api-key: ptm_…"

Connect via REST

Run a tool with one request. The response is { data, error, successful, log_id } for every tool.

terminal
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/LINEAR_LIST_TEAMS \
  -H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
  -d '{ "user_id": "alice", "arguments": {} }'

Linear questions

Other toolkits