list_documents
List Documents
Lists documents in the workspace with pagination support.
Supported Tools
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.
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 Inbound Support Tickets from Slack into Linear
When a support request lands in a Slack channel, automatically extract the key details, create a tracked issue in Linear with the right priority and label, and post a confirmation thread back to the reporter 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. Subscribe to real-time webhooks for changes to issues, projects, cycles, comments, documents, and more.
Frequently asked questions
Common questions about connecting Linear to AI agents with Metorial.
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.Does the Linear integration work with MCP?
Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.How does Metorial control access to Linear?
Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.Can teams trace Linear activity from agents?
Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.