Connect Linear to AI agents

Connect Linear to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

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.

More integrations teams use with Linear

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.

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.

Bitbucket

Manage Git repositories, pull requests, and CI/CD pipelines on Bitbucket Cloud. Create, fork, and configure repositories within workspaces and projects. Create, review, approve, merge, and decline pull requests with inline code comments. Browse source code, list commits, and manage branches and tags. Track issues with the built-in issue tracker. Trigger, monitor, and manage Bitbucket Pipelines. List workspace members, configure repository default reviewers and branch restrictions, create and manage repository webhooks, and search code across repositories.

GitLab

Manage GitLab projects, repositories, issues, merge requests, releases, and CI/CD workflows from one provider. Includes pipeline, job, variable, environment, schedule, trigger, runner, deployment, CI lint, and test report tools.

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. Receive real-time webhook notifications for page changes, new pages, comments, and database schema updates.

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. Subscribe to real-time webhooks for changes to issues, projects, cycles, comments, documents, and more.

Connect Linear to production AI agents

See how Metorial gives Linear access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Linear to AI agents with Metorial.

  1. Can Metorial connect Linear to AI agents?
    Yes. Metorial connects AI agents to Linear through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.