Linear MCP server

Connect Linear to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy LinearBook a demo

What you can do with the Linear MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list documents tool in Linear
  • Use the update cycle tool in Linear
  • Use the update project tool in Linear
  • Use the get team tool in Linear
  • Use the list workflow states tool in Linear
  • Use the create cycle tool in Linear

Supported Tools

list_documents

List Documents

Lists documents in the workspace with pagination support.

update_cycle

Update Cycle

Updates an existing cycle in Linear. Supports changing name, description, and dates.

update_project

Update Project

Updates an existing Linear project. Supports changing name, description, lead, dates, and state.

get_team

Get Team

Retrieves detailed information about a team including its workflow states, labels, and members.

list_workflow_states

List Workflow States

Lists workflow states (issue statuses) across teams. Workflow states define the lifecycle of issues (e.g., Triage, Backlog, Todo, In Progress, Done, Canceled). Use this to find state IDs for creating or updating issues.

create_cycle

Create Cycle

Creates a new cycle (sprint) for a team in Linear. Cycles are time-boxed iterations that contain a set of issues.

get_viewer

Get Current User

Retrieves the profile of the currently authenticated user, including their organization info.

update_issue

Update Issue

Updates an existing Linear issue. Supports changing title, description, priority, assignee, workflow state, labels, estimates, due dates, project, cycle, and parent issue. You can also archive or unarchive issues.

create_issue

Create Issue

Creates a new issue in a Linear team. Supports setting title, description (Markdown), priority, assignee, labels, estimates, due dates, workflow state, parent issue, project, and cycle associations.

list_cycles

List Cycles

Lists cycles (sprints) in Linear, optionally filtered by team.

list_projects

List Projects

Lists all projects in the workspace with pagination support.

delete_issue

Delete Issue

Permanently deletes an issue from Linear. This action cannot be undone. Use "Update Issue" to archive instead if you want to preserve the issue.

list_users

List Users

Lists all users in the workspace. Useful for finding user IDs for assigning issues.

search_issues

Search Issues

Searches Linear issues using text/vector similarity search. Returns matching issues ranked by relevance.

create_project

Create Project

Creates a new project in Linear. Projects group related issues across teams and support tracking progress with milestones and target dates.

get_issue

Get Issue

Retrieves a single Linear issue by ID with full details including sub-issues and comments.

list_labels

List Labels

Lists issue labels, optionally filtered by team. Returns both workspace-level and team-scoped labels.

update_label

Update Label

Updates an existing issue label's name, color, or description.

get_project

Get Project

Retrieves a single project by ID with full details including associated issues.

delete_comment

Delete Comment

Permanently deletes a comment from a Linear issue.

create_comment

Create Comment

Creates a new comment on a Linear issue. Supports Markdown formatting and @mentions using resource URLs.

update_document

Update Document

Updates an existing document's title, content, or project association.

list_issues

List Issues

Lists issues from Linear with optional filtering by team, assignee, project, cycle, or workflow state. Returns paginated results.

create_document

Create Document

Creates a new document in Linear. Documents support rich Markdown content and can be associated with projects.

update_comment

Update Comment

Updates an existing comment on a Linear issue.

create_label

Create Label

Creates a new issue label. Labels can be scoped to a team or shared across the workspace.

list_teams

List Teams

Lists all teams in the workspace. Use this to discover team IDs needed for creating issues, cycles, and filtering.

Connect Linear to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Linear in Metorial. In your Metorial portal, enable the Linear MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Linear tools.

Full Linear + Claude setup guide

Run Linear through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Linear and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Linear tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Linear

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Sentry

Track, manage, and resolve application errors and performance issues. List, query, and bulk-update issues and error events with filters like status, assignment, and tags. Create and manage releases, associate commits, and upload source maps. Configure issue alert rules and metric alert rules with notification actions. Set up cron monitors to detect missed or failed scheduled jobs. Build custom dashboards with configurable widgets. Run ad-hoc Discover queries across errors and transactions for performance analysis. Manage organizations, teams, projects, and members. Provision users via SCIM. Access session replay data.

How to use Linear on Metorial

Automate PR Review Requests from Linear Issues to GitHub

Engineering teams lose time manually creating GitHub pull requests and linking them back to Linear issues. This workflow reads in-progress Linear issues, checks for associated GitHub branches or PRs, and posts review request reminders to Slack when PRs have been open without review for too long.

Compile Weekly Engineering Sprint Reports from Linear and GitHub

At the end of each sprint, automatically gather completed Linear issues, associated pull requests, and deployment activity from GitHub to produce a structured sprint summary for stakeholders.

Compile Weekly Sprint Reports from Linear and Post to Slack

Engineering managers spend significant time assembling sprint status updates from Linear data and distributing them to stakeholders. This workflow pulls current cycle data from Linear, summarizes issue progress by state and assignee, and posts a formatted weekly report to the appropriate Slack channel.

Distribute Figma Design Handoffs to Developers via Linear and Slack

Design-to-development handoffs often break down when developers don't know when designs are ready or where to find them. This workflow reads finalized Figma components, creates Linear issues with exported asset links, and notifies the development team in Slack so implementation can begin immediately.

Figma Design Handoff to Linear Development Issues

When a Figma design is marked ready for development, extract component specifications and design notes, then automatically create structured Linear issues with design links and exported asset references so engineers can start building immediately.

Generate Sprint Retrospective Reports from Linear and Post to Slack

At the end of each sprint cycle, the agent pulls completed and incomplete issues from Linear, summarizes velocity and blockers, and posts a structured retrospective report to the team's Slack channel.

Generate Weekly Sprint Reports from Linear and Post to Slack

At the end of each sprint cycle, pull completed issues, in-progress work, and carry-over items from Linear, compile a structured sprint report, and post it to the engineering team's Slack channel.

Monitor GitHub Actions CI Failures and Create Linear Bug Reports

When a GitHub Actions workflow fails on a main branch, automatically retrieve the failure logs, identify the breaking change, and create a prioritized Linear bug report with full context for the on-call engineer.

SEO Content Gap Analysis and Issue Prioritization

Audit a domain for technical SEO issues, identify keyword gaps against top competitors, and create a prioritized list of content and technical fixes as Linear issues assigned to the content and engineering teams.

Sprint Planning from Slack Discussion to Linear Issues

Capture sprint planning discussions happening in Slack, extract action items, and automatically create prioritized Linear issues with the right assignees and cycle associations to turn conversation into trackable work.

Sprint Planning from Slack Discussions

Capture feature requests and bug reports raised in Slack threads, convert them into structured Linear issues, and organize them into the current sprint with appropriate priorities and assignees.

Sync GitHub Issues to Linear for Cross-Team Engineering Visibility

Engineering teams that use both GitHub and Linear often struggle to keep issue tracking consistent across the two systems. This workflow reads new or updated GitHub issues and creates or updates corresponding Linear issues so product and engineering leadership have a unified view.

Sync New HubSpot Deals to Linear as Tracked Projects

When a deal reaches a key stage in HubSpot, automatically create a corresponding Linear project so revenue-generating commitments are reflected in the engineering and delivery backlog.

Triage GitHub Issues into Linear Sprints with Slack Notifications

When new bugs or feature requests land in GitHub, the agent reads issue details, creates or updates a corresponding Linear issue, assigns it to the right sprint, and posts a triage summary to the engineering Slack channel.

Triage Incoming Support Tickets into Linear Issues

When customer support volume spikes, keeping engineering and support teams aligned is critical. This workflow pulls conversation history from Slack support channels, creates structured Linear issues with priority and labels, and notifies the relevant team channel so nothing falls through the cracks.

Technical notes for Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Frequently asked questions

Common questions about connecting Linear to AI agents with Metorial.

  1. How many tools does the Linear MCP server have?
    The Linear MCP server exposes 27 tools, including List Documents, Update Cycle, Update Project. Each one is governed and traced through Metorial.
  2. Linear exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Linear MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Linear and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Linear MCP server yourself or use the hosted gateway.

Connect Linear to production AI agents

See how Metorial gives your team governed access to Linear, with tracing and security controls built in.

Book a demoDeploy Linear