Connect GitHub Actions to AI agents

Connect GitHub Actions 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

manage_secrets

Manage Secrets

List, get, create/update, or delete Actions secrets at the repository, organization, or environment level. Secret values must be encrypted with the public key before being sent. Use "get_public_key" to retrieve the encryption key needed for creating/updating secrets.

control_workflow_run

Control Workflow Run

Cancel, force-cancel, re-run, or delete a workflow run. Supports re-running all jobs, only failed jobs, or a specific job, optionally with debug logging. Can also approve fork pull request runs and review pending deployments.

trigger_workflow

Trigger Workflow

Trigger a GitHub Actions workflow run via the `workflow_dispatch` event. The workflow must have a `workflow_dispatch` trigger defined in its YAML file. You can pass custom inputs that are defined in the workflow file.

get_workflow_run

Get Workflow Run

Get detailed information about a specific workflow run, including its status, conclusion, timing, and associated commit. Can include one page of jobs from the latest attempt and their step-level details; use jobsNextPage to retrieve additional jobs.

manage_variables

Manage Variables

List, get, create, update, or delete Actions configuration variables at the repository, organization, or environment level. Unlike secrets, variable values are visible in API responses.

list_artifacts

List Artifacts

List workflow artifacts for a repository or a specific workflow run. Artifacts enable data sharing between jobs and persist after workflow completion. Returns artifact metadata including size, expiration, and download information.

manage_artifact

Manage Artifact

Inspect, download a ZIP archive of, or permanently delete a workflow artifact. Expired or deleted artifacts cannot be downloaded.

list_workflows

List Workflows

List GitHub Actions workflows defined in a repository. Returns workflow definitions including their state (active/disabled), and file paths. Use this to discover available workflows before triggering or inspecting runs.

manage_caches

Manage Caches

List, inspect, and delete GitHub Actions caches for a repository. Caches can be filtered by key prefix and git ref. Supports deleting by cache ID or cache key.

manage_runners

Manage Runners

List, inspect, remove, and manage self-hosted runners at the repository or organization level. Create registration and removal tokens, and manage custom labels on runners.

manage_permissions

Manage Permissions

Get or set GitHub Actions permissions for a repository. Configure whether Actions is enabled, which actions are allowed, default GITHUB_TOKEN permissions, and whether GITHUB_TOKEN can approve pull requests. Selected-action policy requires allowedActions to be selected.

get_workflow_run_logs

Get Workflow Run Logs

Download workflow run logs as a ZIP archive or individual job logs as text. Can also permanently delete run logs.

list_workflow_runs

List Workflow Runs

List workflow runs for a repository, optionally filtered by a specific workflow, branch, event, status, or actor. Returns run status, conclusions, and metadata for each run.

manage_workflow_state

Manage Workflow State

Enable or disable a GitHub Actions workflow. Disabled workflows will not be triggered by events. Also retrieves workflow details. The legacy get_usage action calls a GitHub endpoint that is closing down and may be unavailable.

get_current_user

Get Current User

Identify the GitHub user represented by the connected OAuth token or personal access token.

list_pending_deployments

List Pending Deployments

Inspect environment reviews pending for a workflow run, including environment IDs needed to approve or reject a deployment. Reading this list does not approve a deployment.

More integrations teams use with GitHub Actions

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.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

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.

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.

Technical notes for GitHub Actions

Manage GitHub Actions workflows, runs, jobs, artifact and log downloads, encrypted secrets, visible variables, caches, self-hosted runners, and repository Actions policies. Dispatch and rerun workflows, inspect pending environment reviews, and identify the connected GitHub user.

Connect GitHub Actions to production AI agents

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

Frequently asked questions

Common questions about connecting GitHub Actions to AI agents with Metorial.

  1. Can Metorial connect GitHub Actions to AI agents?
    Yes. Metorial connects AI agents to GitHub Actions 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.