> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/harness-ai/use-harness-ai/core-capabilities/in-your-ide/antigravity-plugin.md).

# Antigravity Plugin for Harness

Install the Antigravity Plugin for Harness to connect your AI agent to Harness and use workflow skills for pipelines, deployments, and security

The Antigravity Plugin for Harness connects Google Antigravity to your Harness account through the hosted Model Context Protocol (MCP) server. Use natural language to investigate pipeline failures, review deployments, and draft configuration with 71 bundled Harness workflow skills.

Go to the [Antigravity Plugin for Harness repository](https://github.com/harness/harness-antigravity) to download the plugin and review its source.

## What you will learn from this topic

By the end of the topic, you will be able to:

* Install the plugin from the repository using the Antigravity CLI.
* Authenticate with Harness through OAuth.
* Verify the connection with a read-only request.
* Use Harness workflow skills in your agent conversations.

## Before you begin

Before you istall the Antigravity Plugin for Harness, ensure you have the following:

* Antigravity CLI (`agy`). Go to [Google's CLI installation guide](https://www.antigravity.google/docs/cli/install/) to install it for your operating system.
* Git to clone the plugin repository.
* Harness account with access to the organizations, projects, and resources you want to use.
* Hosted MCP OAuth enabled for your Harness account. Go to [Harness Support](https://support.harness.io) to request enablement if it is not already available.

The default connection uses hosted OAuth at `https://mcp.harness.io/mcp`. You do not need a personal access token (PAT), a local MCP server, or Python for this connection.

## Install and connect

{% stepper %}
{% step %}

### Step 1: Install the plugin

Clone the repository:

```bash
git clone https://github.com/harness/harness-antigravity.git
cd harness-antigravity
```

Validate the package:

```bash
agy plugin validate .
```

Install the plugin locally:

```bash
agy plugin install .
```

Verify the installed state:

```bash
agy plugin list --json
```

Confirm that `harness-antigravity` is enabled and that its inventory includes 71 skills, one rule, and the `harness` MCP server. Go to [Client compatibility](#client-compatibility) to review known validation warnings.
{% endstep %}

{% step %}

### Step 2: Sign in to Antigravity

Start the CLI from the project directory where you want to work:

```bash
agy
```

Complete Antigravity sign-in if prompted. This authenticates your Google account with Antigravity; you connect your Harness account separately in the next step.
{% endstep %}

{% step %}

### Step 3: Authenticate with Harness

Enter `/mcp` in the interactive CLI. Under **Plugins**, select the Harness server. In CLI 1.4.2, its name is `harness-antigravity_harness`.

Select **Authenticate** and complete Harness sign-in in the browser. If the callback displays an authorization code, paste it into the CLI's authorization-code field.

Return to the MCP panel. Confirm that the server shows **Authed** and that Harness tools are listed.

Keep authorization codes and tokens out of agent conversations, repository files, and shared logs.
{% endstep %}

{% step %}

### Step 4: Verify a read-only request

Ask the agent to list projects:

```
Use the Harness MCP connection to list up to five projects accessible
in my authenticated account. Report the account and organization scope
from the result. Do not make changes. If scope is required, ask me for it.
```

A successful response containing Harness project data verifies API access. An installed plugin or an **Authed** label alone does not verify access to a particular resource.

For subsequent requests, specify the account, organization, and project you intend to use.
{% endstep %}
{% endstepper %}

## Use Harness in Antigravity

Describe the outcome you want in the agent conversation. Bundled skills provide Harness-specific procedures, while MCP tools read or act on Harness resources using your authenticated permissions. Go to the [skill catalog](https://github.com/harness/harness-antigravity/blob/main/SKILLS.md) to explore the workflows and their prerequisites.

| Workflow                 | Example request                                                                                                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pipeline troubleshooting | In account `<account>`, organization `<org>`, project `<project>`, inspect the latest failed execution of pipeline `<pipeline>` and explain the failure. Do not rerun it. |
| Pipeline authoring       | Draft a CI pipeline for this Node.js repository. Show me the YAML and required connectors before saving anything to Harness.                                              |
| Deployment readiness     | Review deployment readiness for service `<service>` in project `<project>` and organization `<org>`. Report missing dependencies without changing resources.              |
| Security investigation   | Summarize security findings for project `<project>` in organization `<org>`. Group them by severity and recommend next steps. Do not change exemptions.                   |
| Feature management       | Review the targeting configuration for flag `<flag>` in the specified Harness scope and explain its behavior without changing it.                                         |

Available operations depend on your Harness modules, resource permissions, and each skill's prerequisites. Review proposed changes and the target scope before approving write or execution requests.

{% hint style="info" %}
The plugin includes runtime instructions for scope and workflow handling. It does not install automatic governance hooks. The bundled `configure-agent-pr-attestation` skill is a reference for Claude Code projects, not an Antigravity hook.
{% endhint %}

## Client compatibility

Installation, discovery of all 71 skills, hosted OAuth, and a read-only project listing were verified with Antigravity CLI 1.4.2. This smoke test does not establish that every bundled workflow has been tested end to end.

{% hint style="warning" %}
CLI 1.4.2 loads only the first 24,000 bytes of a skill body. The bundled `dbops-changeset` and `exempt-vuln` skills exceed this limit, so their instructions are truncated. Avoid relying on these two skills for complete workflows until the compatibility issue is resolved.
{% endhint %}

Native validation passes with warnings in this client. Strict validation reports five warnings: the two oversized skills, the root development `AGENTS.md`, and the manifest fields `category` and `mcpServers`. The runtime rule in `rules/AGENTS.md` and the default `mcp_config.json` are discovered successfully.

Go to the repository's [validation status](https://github.com/harness/harness-antigravity/blob/main/docs/VALIDATION.md) to review recorded checks and remaining limitations.

### Troubleshooting

<details>

<summary>The server shows Unauthorized or Auth Needed</summary>

Open `/mcp`, select the Harness server, and select **Authenticate**. If authentication still fails, confirm that hosted MCP OAuth is enabled for your Harness account. Record the error without including authorization codes or tokens when contacting support.

</details>

<details>

<summary>The standalone MCP command shows no servers</summary>

In CLI 1.4.2, `agy mcp list` can report no configured servers even when the plugin's server is installed. Use `agy plugin list --json` to inspect the plugin inventory and `/mcp` inside the running CLI to inspect its connection.

</details>

<details>

<summary>Authentication succeeds but a resource read fails</summary>

Confirm the account, organization, project, and resource identifiers. Check that your Harness role permits the requested read and that the relevant module is available. A successful project listing does not grant access to every resource in that project.

</details>

## Next steps

* [Plugin repository](https://github.com/harness/harness-antigravity): Review updates and connection options, including the optional local PAT profile.
* [Harness MCP Server](https://developer.harness.io/harness-ai/use-harness-ai/connect-with-ai/index.md): Explore the server and supported configuration options.
* [Harness Skills](https://developer.harness.io/harness-ai/use-harness-ai/govern-ai-output/harness-skills.md): Understand how workflow skills guide agent tasks.

{% @harness-feedback/feedback %}
