drift.flanj.io / servers / linear
Server sheet · api · credentialed
Linear linear
12 change events over 51 comparison days: 9 breaking, 21 warning and 0 info findings, each with the two contracts as served behind it.
01 / the server
What the watch knows about it.
https://mcp.linear.app/mcpendpoint
Linearoperator
apikind
credentialedauth posture
59tools listed
52days observed
2026-07-28MCP revision · floor, not ceiling
0 / 59outputSchema declared
This server answers tools/list only with a credential attached, so its findings cannot be reproduced anonymously; the watch attaches the credential the operator documents for machine access.
02 / event timeline — every event, expanded
12 change events, newest first.
2026-10-14 → 2026-10-15 7 warning 7 tools
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
get_status_updates description
List or get project/initiative status updates. updates with their body, health, author, and parent project or initiative. Pass `id` id to get a specific update, or filter one update and ignore list filters; omit id to list.
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
get_user description
Retrieve details of a specific Linear user one user's profile, email, admin, guest, and active flags, plus team IDs, names, and keys. Use list_users to find matching users.
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
get_workspace description
Retrieve the connected Linear workspace's ID, name, and URL to confirm which workspace you are using
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
list_cycles description
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
list_users description
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
save_status_update description
Create or update a project/initiative status update and return the saved update. Omit `id` to To create, omit id and provide `id` to update. body plus project or initiative matching type. To update, provide id; project and initiative are ignored.
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
search_documentation description
Search Linear's product documentation to learn about features for feature and usage guidance. Returns up to five results with titles, URLs, and content snippets per page.
2026-10-06 → 2026-10-07 2 warning 2 tools
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
get_team description
Retrieve details of a specific Linear team team, including its parent ID and hierarchy name. Use list_teams with parentTeam or ancestorTeam to find its sub-teams
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
list_teams description
List teams in the user's Linear workspace workspace, including their parent IDs and hierarchy names
2026-10-05 → 2026-10-06 1 warning 1 tool
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
get_issue description
[…] and active Triage Intelligence suggestions when the issue is in triage triage. A nonempty fields selection overrides the include options; request optional fields directly in fields.
2026-09-23 → 2026-09-24 1 warning 1 tool
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
list_issues description
[…] including active Triage Intelligence suggestions for issues in triage. For my issues, issues assigned to me, use "me" as the assignee. For issues created by me, use "me" as the creator. Use "null" for no assignee.
2026-09-22 → 2026-09-23 9 breaking 9 tools
breaking
catalog
operation-removed
Every call to that tool now fails; an agent that learned it yesterday has nothing to call today.
credentialed
#
delete_diff_comment
their contract · 2026-09-22
"delete_diff_comment"
their contract · 2026-09-23
absent
breaking
catalog
operation-removed
Every call to that tool now fails; an agent that learned it yesterday has nothing to call today.
credentialed
#
get_diff
their contract · 2026-09-22
"get_diff"
their contract · 2026-09-23
absent
breaking
catalog
operation-removed
Every call to that tool now fails; an agent that learned it yesterday has nothing to call today.
credentialed
#
get_diff_threads
their contract · 2026-09-22
"get_diff_threads"
their contract · 2026-09-23
absent
breaking
catalog
operation-removed
Every call to that tool now fails; an agent that learned it yesterday has nothing to call today.
credentialed
#
list_diffs
their contract · 2026-09-22
"list_diffs"
their contract · 2026-09-23
absent
breaking
catalog
operation-removed
Every call to that tool now fails; an agent that learned it yesterday has nothing to call today.
credentialed
#
merge_diff
their contract · 2026-09-22
"merge_diff"
their contract · 2026-09-23
absent
breaking
catalog
operation-removed
Every call to that tool now fails; an agent that learned it yesterday has nothing to call today.
credentialed
#
resolve_diff_thread
their contract · 2026-09-22
"resolve_diff_thread"
their contract · 2026-09-23
absent
breaking
catalog
operation-removed
Every call to that tool now fails; an agent that learned it yesterday has nothing to call today.
credentialed
#
save_diff_comment
their contract · 2026-09-22
"save_diff_comment"
their contract · 2026-09-23
absent
breaking
catalog
operation-removed
Every call to that tool now fails; an agent that learned it yesterday has nothing to call today.
credentialed
#
submit_diff_review
their contract · 2026-09-22
"submit_diff_review"
their contract · 2026-09-23
absent
breaking
catalog
operation-removed
Every call to that tool now fails; an agent that learned it yesterday has nothing to call today.
credentialed
#
update_diff
their contract · 2026-09-22
"update_diff"
their contract · 2026-09-23
absent
2026-09-16 → 2026-09-17 1 warning 1 tool
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
list_project_labels description
List available project labels in the a Linear workspace. workspace or team. Returns workspace labels by default; pass `team` to also include that team's labels. A team-scoped label carries a `team` field; different teams can […]
2026-09-14 → 2026-09-15 1 warning 1 tool
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
save_project description
[…] without resending all of it, pass `patch` instead of `description`. `state` resolves against the project statuses of the lead team, so pass `leadTeam` when creating a multi-team project whose teams use different statuses.
2026-09-10 → 2026-09-11 2 warning 2 tools
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
get_attachment description
Retrieve an attachment's content issue attachment by ID. Use format=url to get its title and download URL without fetching the file content. Linear upload URLs are signed for five minutes; call again to refresh. External URLs are returned unchanged. Files embedded in comments have no issue attachment ID; use the URLs in list_comments attachments instead. Download and process documents with your own file tools.
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
list_comments description
[…] set, `onBehalfOf` identifies the user the agent author acted for. Files uploaded in comment bodies are returned in `attachments` with titles and download URLs, not issue attachment IDs. Signed upload URLs expire after five minutes; call list_comments again to refresh them. Download documents using these URLs and process them with your own file tools.
2026-09-06 → 2026-09-07 2 warning 2 tools
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
list_issue_labels description
List available issue labels in a Linear workspace or team team. A retired label carries `retiredAt` and cannot be applied to new issues.
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
list_project_labels description
List available project labels in the Linear workspace workspace. A team-scoped label carries a `team` field; different teams can hold same-named labels, so check it before acting on an ID. A retired label carries `retiredAt` and cannot be applied to new projects.
2026-09-04 → 2026-09-05 1 warning 1 tool
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
create_issue_label description
Create a new Linear issue label label. Deprecated: use `save_issue_label`, which can also update labels.
2026-08-27 → 2026-08-28 2 warning 2 tools
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
save_issue description
[…] the existing issue; otherwise creates a new one. When creating, `title` and `team` are required. is required, and `title` is required unless `template` is set. Note: use `assignee` (not `assigneeId`) to set the assignee — […]
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
save_project description
[…] at least one team (via `addTeams` or `setTeams`) are required. Pass `template` to create the project from a project template. To change parts of the description without resending all of […]
2026-08-26 → 2026-08-27 1 warning 1 tool
warning
wording
description-changed
The wording an agent reads to choose and call the tool changed; its behaviour may or may not have.
credentialed
#
save_document description
Create or update a Linear document. If `id` is provided, updates edits the existing document; otherwise creates a new one. When creating, […]
03 / tool inventory · as served on 2026-10-15
59 tools in the latest contract.
From the snapshot as served; descriptions shortened to their first sentence. “Changes” counts this server’s findings on the tool.
| Tool | Description | Inputs | Required | outputSchema | Annotations | Changes |
|---|---|---|---|---|---|---|
| create_attachment | Deprecated fallback for tiny files only. | 8 | 5 | none | 0 | |
| create_attachment_from_upload | Link an already-uploaded Linear assetUrl to an existing issue as an attachment. | 4 | 2 | none | 0 | |
| create_issue_label | Create a new Linear issue label. | 6 | 1 | none | 1 | |
| delete_attachment | Delete an attachment by ID | 1 | 1 | none | destructive | 0 |
| delete_comment | Delete a Linear comment. | 1 | 1 | none | destructive | 0 |
| delete_status_update | Delete (archive) a project or initiative status update. | 2 | 2 | none | destructive | 0 |
| extract_images | Extract and fetch images from markdown content. | 1 | 1 | none | readOnly · idempotent | 0 |
| get_agent_skill | Retrieve a Linear Agent skill by ID, including its full markdown instructions. | 1 | 1 | none | readOnly · idempotent | 0 |
| get_attachment | Retrieve an issue attachment by ID. | 2 | 1 | none | readOnly · idempotent | 1 |
| get_document | Retrieve a Linear document by ID or slug | 1 | 1 | none | readOnly · idempotent | 0 |
| get_issue | Retrieve detailed information about an issue by ID, including attachments, git branch name, and active Triage Intelligence suggestions when the issue is in triage. | 5 | 1 | none | readOnly · idempotent | 1 |
| get_issue_status | Retrieve detailed information about an issue status in Linear by name or ID | 3 | 3 | none | readOnly · idempotent | 0 |
| get_milestone | Retrieve details of a specific milestone by ID or name | 2 | 2 | none | readOnly · idempotent | 0 |
| get_notifications | Get a page of notifications from the authenticated user's Linear inbox. | 3 | 0 | none | readOnly · idempotent | 0 |
| get_project | Retrieve details of a specific project in Linear | 7 | 1 | none | readOnly · idempotent | 0 |
| get_release | Retrieve details of a release by ID or slug. | 2 | 1 | none | readOnly · idempotent | 0 |
| get_release_note | Retrieve release notes by ID or slug, including markdown content. | 2 | 1 | none | readOnly · idempotent | 0 |
| get_status_updates | List or get project/initiative status updates with their body, health, author, and parent project or initiative. | 11 | 1 | none | readOnly · idempotent | 1 |
| get_team | Retrieve details of a specific Linear team, including its parent ID and hierarchy name. | 1 | 1 | none | readOnly · idempotent | 1 |
| get_template | Retrieve a Linear template by ID or name: the content it pre-fills, the ids it applies, its sub-issues, and its form fields. | 1 | 1 | none | readOnly · idempotent | 0 |
| get_triage_responsibility | Retrieve who is responsible for a team's triage: the person on triage now, what happens when an issue enters triage, and the upcoming shifts of the team's triage rotation. | 3 | 1 | none | readOnly · idempotent | 0 |
| get_user | Retrieve one user's profile, email, admin, guest, and active flags, plus team IDs, names, and keys. | 1 | 1 | none | readOnly · idempotent | 1 |
| get_workspace | Retrieve the connected workspace's ID, name, and URL to confirm which workspace you are using | 0 | 0 | none | readOnly · idempotent | 1 |
| list_agent_skills | List Linear Agent skills available to the authenticated user. | 3 | 0 | none | readOnly · idempotent | 0 |
| list_comments | List comments on a Linear issue, project, initiative, document, project milestone, or project/initiative status update. | 10 | 0 | none | readOnly · idempotent | 1 |
| list_custom_views | Find saved issue, project, and initiative views accessible to the user, including personal, workspace, and team views. | 7 | 0 | none | readOnly · idempotent | 0 |
| list_cycles | List a team's cycles with their IDs, numbers, dates, and issue and scope histories | 2 | 1 | none | readOnly · idempotent | 1 |
| list_documents | List documents in the user's Linear workspace | 12 | 0 | none | readOnly · idempotent | 0 |
| list_issue_labels | List available issue labels in a Linear workspace or team. | 7 | 0 | none | readOnly · idempotent | 1 |
| list_issue_statuses | List available issue statuses in a Linear team | 1 | 1 | none | readOnly · idempotent | 0 |
| list_issues | List issues in the user's Linear workspace, including active Triage Intelligence suggestions for issues in triage. | 22 | 0 | none | readOnly · idempotent | 1 |
| list_milestones | List all milestones in a Linear project | 1 | 1 | none | readOnly · idempotent | 0 |
| list_project_labels | List available project labels in a Linear workspace or team. | 7 | 0 | none | readOnly · idempotent | 2 |
| list_projects | List projects in the user's Linear workspace | 17 | 0 | none | readOnly · idempotent | 0 |
| list_release_notes | List release notes in the workspace, optionally filtered by pipeline or covered release. | 11 | 0 | none | readOnly · idempotent | 0 |
| list_release_pipelines | List release pipelines in the workspace. | 12 | 0 | none | readOnly · idempotent | 0 |
| list_releases | List releases in the workspace, with optional filtering by pipeline, stage, version, and text. | 13 | 0 | none | readOnly · idempotent | 0 |
| list_teams | List teams in the user's Linear workspace, including their parent IDs and hierarchy names | 9 | 0 | none | readOnly · idempotent | 1 |
| list_templates | List the Linear issue, project, and document templates available to the authenticated user. | 2 | 0 | none | readOnly · idempotent | 0 |
| list_users | List workspace users with their IDs, names, emails, and admin, guest, and active flags. | 5 | 0 | none | readOnly · idempotent | 1 |
| mark_notification | Mark a Linear inbox notification as read or unread, or snooze or unsnooze it. | 3 | 1 | none | 0 | |
| prepare_attachment_upload | Prepare a direct Linear file upload for an existing issue. | 6 | 4 | none | 0 | |
| restore_issue_label | Restore a retired Linear issue label, making it available for use on issues again. | 1 | 1 | none | destructive | 0 |
| restore_project_label | Restore a retired Linear project label, making it available for use on projects again. | 1 | 1 | none | destructive | 0 |
| retire_issue_label | Retire a Linear issue label so it cannot be applied to new issues. | 1 | 1 | none | destructive | 0 |
| retire_project_label | Retire a Linear project label so it cannot be applied to new projects. | 1 | 1 | none | destructive | 0 |
| save_comment | Create or update a comment on a Linear issue, project, initiative, document, project milestone, or project/initiative status update. | 10 | 1 | none | destructive | 0 |
| save_document | Create or update a Linear document. | 11 | 0 | none | destructive | 1 |
| save_issue | Create or update a Linear issue. | 32 | 0 | none | destructive | 1 |
| save_issue_label | Create or update a Linear issue label. | 8 | 0 | none | destructive | 0 |
| save_milestone | Create or update a milestone in a Linear project. | 5 | 1 | none | destructive | 0 |
| save_project | Create or update a Linear project. | 24 | 0 | none | destructive | 2 |
| save_project_label | Create or update a Linear project label. | 7 | 0 | none | destructive | 0 |
| save_release | Create or update a release. | 12 | 0 | none | destructive | 0 |
| save_release_note | Create or update release notes. | 8 | 0 | none | destructive | 0 |
| save_status_update | Create or update a project/initiative status update and return the saved update. | 7 | 1 | none | destructive | 1 |
| search_documentation | Search Linear's product documentation for feature and usage guidance. | 2 | 1 | none | readOnly · idempotent | 1 |
| share_issue | Share an issue with a workspace user who cannot otherwise access it. | 2 | 2 | none | destructive | 0 |
| unshare_issue | Remove a workspace user's shared access to an issue. | 2 | 2 | none | destructive | 0 |