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.

How the workflow runs

The scenario uses specific integration tools at each step, while Metorial keeps access scoped and visible.

  1. 1

    Retrieve recent GitHub issues

    List recently created or updated issues from the target GitHub repository, filtering by label or milestone as needed.

    • github:list_issues
  2. 2

    Fetch full issue details

    Get the complete body, labels, assignees, and metadata for each issue to prepare for mapping.

    • github:get_issue
  3. 3

    Check for existing Linear counterparts

    Search Linear for issues that reference the same GitHub issue ID to determine whether to create or update.

    • linear:search_issues
  4. 4

    Create new Linear issues

    For issues not yet tracked in Linear, create a corresponding issue with appropriate priority, labels, and a link back to the GitHub issue.

    • linear:create_issue
  5. 5

    Update changed Linear issues

    For issues already in Linear, update the state, description, or metadata to reflect changes made in GitHub.

    • linear:update_issue

Integrations used in this scenario

github

List Issues

Retrieve recent or updated issues from the GitHub repository.

View details

github

Get Issue

Fetch full details of a specific GitHub issue including labels and assignees.

View details

linear

Search Issues

Search Linear for an existing issue linked to the GitHub issue to avoid duplicates.

View details

linear

Create Issue

Create a new Linear issue with mapped priority, labels, and description from the GitHub issue.

View details

linear

Update Issue

Update an existing Linear issue if the GitHub issue has changed state or details.

View details

Connected systems

Integration

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.

View GitHub

Integration

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.

View Linear

Expected outcomes

Outcome 1

Product and engineering teams share a consistent view of outstanding work across GitHub and Linear

Metorial keeps the workflow connected, governed, and traceable across the systems involved.

Explore scenarios

Outcome 2

Duplicate issue creation is avoided through pre-creation search

Metorial keeps the workflow connected, governed, and traceable across the systems involved.

Explore scenarios

Outcome 3

State changes in GitHub are reflected in Linear without manual synchronization

Metorial keeps the workflow connected, governed, and traceable across the systems involved.

Explore scenarios

How Metorial powers this scenario

Metorial is the governed connection layer between your AI agents and the tools your company runs on. It turns workflows like sync github issues to linear for cross-team engineering visibility into something you can deploy quickly, safely, and at scale.

Fast

Ready for your entire team

Connect 1000+ verified integrations through one Magic MCP URL instead of building and maintaining bespoke connectors for each system in this workflow.

Browse integrations

Secure

Guardrails on every action

Protoguard inspects every message and tool call for prompt injection and policy violations before an agent touches your systems.

See how Protoguard works

Enterprise

SSO, policies, and audit trails

Agents act on real identity under company SSO, with per-user and per-group access policies and a complete, searchable record of everything that happens.

Explore enterprise

Team ready

Reusable across your org

Package this workflow as a skill, attach the tools it needs, and let teammates run it through Portals — governed by admins, owned by the people who do the work.

See Skills & Portals

Products behind this workflow

The Metorial products that connect, govern, and observe this scenario.

Connectivity

Integrations

Start from 1000+ verified integrations or bring your own, and give every one a governed path to your agents under existing SSO and access policies.

Explore Integrations

Connectivity

Magic MCP

A single URL your AI client connects to. Sign in with the login you already use and your agent reaches every integration and tool you allow — no per-app setup.

Explore Magic MCP

Identity

Access Control

Sign in with company SSO, set policies per user and group, and let agents act on real identity across every connected system in this workflow.

Explore Access Control

Governance

Protoguard

Metorial’s security layer reviews every message and tool request before an agent acts — catching prompt injection and blocking anything outside your policies.

Explore Protoguard

Observability

Tracing

A complete, searchable record of everything your agents, team, and machines do across these integrations, so you can trust the workflow in production.

Explore Tracing

Governance

Portals

Let teammates connect agents to the integrations and skills your company already uses, with admins deciding who gets access to what.

Explore Portals

Built for your whole team

However you adopt AI, Metorial has a path for connecting it safely.

Solution

For Agents

Give the agents behind this scenario governed access to every tool and integration they need, with one connection layer instead of bespoke glue code.

Agents solution

Solution

For Enterprise

SSO, granular access control, security review, and full audit trails so this workflow meets enterprise governance and compliance requirements.

Enterprise solution

Solution

For your Workforce

Let the people who do this work connect their own AI agents to approved integrations and reusable skills — safely, without waiting on engineering.

Workforce solution

Build this workflow with your own tools

Metorial gives teams one governed layer for connecting integrations to real production work.