Connect CircleCI to Your AI Agent

Choose a project and branch for a status brief, or name a workflow for a performance question. AI can explain the run records and trigger a specific pipeline when requested.

11 tools API key

Try a CircleCI Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill CircleCI

Prepare a Pipeline Status Brief

Read project pipelines and their workflows to summarize run states and errors.

/oo CircleCI: List CircleCI pipelines for project [project slug] on branch [branch], then read pipelines [pipeline IDs] and their workflows. Summarize states, recorded errors, and runs needing attention.

Explain Workflow Performance Metrics

Read Insights metrics and trends to compare the reported workflow performance.

/oo CircleCI: Read CircleCI Insights summary for project [project slug], workflow [workflow name], branch [branch]. Explain the returned metrics and trends for [performance question], separating observations from hypotheses.

Trigger a Specified Pipeline

Start a pipeline for your chosen project, branch or tag, and supplied parameters.

/oo CircleCI: Trigger CircleCI project [project slug] on branch [branch] with approved pipeline parameters [parameters]. Return the pipeline ID, number, and initial state.

Start Working with CircleCI

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect CircleCI

    Connect with a CircleCI personal API token.

    Connect CircleCI →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A CircleCI personal API token with access to the target projects.
  • Project tokens are not supported by these API v2 operations.

CircleCI Tools

CircleCI pipeline, workflow, and job records describe build execution, while Insights summaries provide metrics and trends. They support status reporting and focused performance analysis.

Read Pipelines, Workflows, and Jobs

List or retrieve pipelines, list workflows, read job details, and list job artifacts.

Read Insights Summaries

Read workflow metrics and trends or an organization Insights summary.

Trigger a Pipeline

Start a new pipeline with branch, tag, or supplied parameters.

11 tools

Get Current User

Get the currently authenticated CircleCI user profile.

circleci.get_current_user

Get Project

Get CircleCI project details by project slug.

circleci.get_project

List Pipelines For Project

List CircleCI pipelines for a project.

circleci.list_pipelines_for_project

Get Pipeline

Get a CircleCI pipeline by pipeline ID.

circleci.get_pipeline

List Workflows By Pipeline

List workflows for a CircleCI pipeline.

circleci.list_workflows_by_pipeline

Get Workflow Summary

Get CircleCI Insights summary metrics for a workflow.

circleci.get_workflow_summary

Get Job Details

Get CircleCI job details by project slug and job number.

circleci.get_job_details

Get Job Artifacts

List artifacts for a CircleCI job.

circleci.get_job_artifacts

List Insights Summary

Get CircleCI Insights summary metrics for an organization.

circleci.list_insights_summary

Trigger Pipeline

Trigger a new CircleCI pipeline for a project.

circleci.trigger_pipeline

List Project Env Vars

List masked CircleCI environment variables for a project.

circleci.list_project_env_vars

Frequently Asked Questions

What project identifier should I provide?

Provide the CircleCI project slug used for the project. Pipeline IDs and job numbers identify specific runs within the relevant project.

Can a review include job artifact references?

Yes. Provide the project slug and job number to list artifacts; this returns artifact records rather than their full file contents.

Does this fetch complete job logs?

No. Job details describe status and run context. Detailed failure analysis may need logs supplied separately.

Connect CircleCI

About CircleCI ↗