Skip to main content

Linear connector

Back to the connector overview, authentication methods, and actions.
​
24 Jul 2026
bug-fixFixed tool-selection issues from MCP testing - delete_document now documents the working move-to-trash and update_document drops the non-functional trashed field, delete_attachment and update_attachment are disambiguated, and create_initiative_update marks body optional with body and bodyData mutually exclusive.
linear_create_initiative_update, linear_delete_attachment, linear_delete_document, linear_update_attachment, linear_update_document
​
22 Jul 2026
new-actions bug-fixAdded list_favorites and list_team_memberships so delete_favorite and delete_team_membership can resolve the IDs they need. Fixed customer tier renames and the list_comments issue filter, and clarified several tool descriptions (file_upload, batch_update_issues, update_user, update_customer_need priority, list_issue_labels, create_favorite). No authentication changes.
linear_list_favorites, linear_list_team_memberships
linear_batch_update_issues, linear_create_customer_need, linear_create_favorite, linear_file_upload, linear_get_customer_need, linear_get_customer_tier, linear_list_comments, linear_list_issue_labels, linear_update_customer_need, linear_update_customer_tier, linear_update_user
​
21 Jul 2026
bug-fix guide-fixAdded the admin scope to the default OAuth 2.0 scope request (read,write,admin) so admin-gated actions — webhook management, organization/workspace settings, and customer status, customer tier, and project status create/update/delete — work after reconnecting; Linear treats admin as a separate token grant from the user’s role, so these previously failed with “admin required” even for workspace admins. Corrected requiredScopes from write to admin on the customer-status, customer-tier, and project-status create/update/delete/archive actions to match Linear’s real permission requirements (their read/list/get actions remain on read). Also updated the OAuth scope guide to explain the admin requirement. Existing OAuth connections must reconnect to grant the admin scope.
linear_archive_cycle, linear_archive_initiative, linear_archive_issue, linear_archive_project, linear_archive_project_status, linear_batch_create_issues, linear_batch_update_issues, linear_complete_release, linear_create_attachment, linear_create_comment, linear_create_custom_view, linear_create_customer, linear_create_customer_need, linear_create_customer_status, linear_create_customer_tier, linear_create_cycle, linear_create_document, linear_create_favorite, linear_create_initiative, linear_create_initiative_to_project, linear_create_initiative_update, linear_create_issue, linear_create_issue_label, linear_create_issue_relation, linear_create_notification_subscription, linear_create_project, linear_create_project_label, linear_create_project_milestone, linear_create_project_status, linear_create_project_update, linear_create_reaction, linear_create_release, linear_create_team, linear_create_team_membership, linear_create_template, linear_create_webhook, linear_create_workflow_state, linear_delete_attachment, linear_delete_comment, linear_delete_custom_view, linear_delete_customer, linear_delete_customer_need, linear_delete_customer_status, linear_delete_customer_tier, linear_delete_document, linear_delete_favorite, linear_delete_initiative, linear_delete_initiative_to_project, linear_delete_issue, linear_delete_issue_label, linear_delete_issue_relation, linear_delete_project, linear_delete_project_label, linear_delete_project_milestone, linear_delete_reaction, linear_delete_release, linear_delete_team, linear_delete_team_membership, linear_delete_template, linear_delete_webhook, linear_file_upload, linear_get_agentSession, linear_get_application_info, linear_get_comment, linear_get_customer, linear_get_customer_need, linear_get_customer_status, linear_get_customer_tier, linear_get_cycle, linear_get_document, linear_get_external_user, linear_get_initiative, linear_get_issue, linear_get_issue_label, linear_get_project, linear_get_project_label, linear_get_project_milestone, linear_get_project_status, linear_get_team, linear_get_user, linear_get_viewer, linear_get_webhook, linear_get_workflow_state, linear_issue_filter_suggestion, linear_list_agentSessions, linear_list_comments, linear_list_customer_needs, linear_list_customer_statuses, linear_list_customer_tiers, linear_list_customers, linear_list_cycles, linear_list_documents, linear_list_external_users, linear_list_initiatives, linear_list_issue_labels, linear_list_issues, linear_list_project_labels, linear_list_project_milestones, linear_list_project_statuses, linear_list_projects, linear_list_teams, linear_list_users, linear_list_webhooks, linear_list_workflow_states, linear_organization_invite_create, linear_organization_update, linear_resolve_comment, linear_rotate_webhook_secret, linear_search_issues, linear_unarchive_issue, linear_unified_get_me, linear_unresolve_comment, linear_update_attachment, linear_update_comment, linear_update_custom_view, linear_update_customer, linear_update_customer_need, linear_update_customer_status, linear_update_customer_tier, linear_update_cycle, linear_update_document, linear_update_initiative, linear_update_issue, linear_update_issue_label, linear_update_project, linear_update_project_label, linear_update_project_milestone, linear_update_project_status, linear_update_release, linear_update_team, linear_update_template, linear_update_user, linear_update_webhook, linear_update_workflow_state, linear_upsert_customer, linear_user_suspend
​
17 Jul 2026
guide-fix improvementAdded a connection test action (get_viewer) for the API Key auth method, added portal-step screenshots to the API Key config and OAuth 2.0 setup connection guides, and fixed guide audit findings — added the create-key step, corrected UI labels (Security & access, Redirect URIs, the New OAuth application + button), documented the optional OAuth application fields and toggles, added a Developer URL example, and added detailed OAuth scope guidance plus the minimum Read permission requirement.