# Harness MCP Server (MCP server)

> Harness MCP Server is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. An MCP (Model Context Protocol) server that gives AI agents full access to the Harness.io platform through 11 consolidated… It has 110 GitHub stars, is released under the MIT license and runs locally with npx -y harness-mcp-v2.

An MCP (Model Context Protocol) server that gives AI agents full access to the Harness.io platform through 11 consolidated tools and 262 resource types.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/harness/mcp-server |
| GitHub stars | 110 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: harness-mcp-v2 |
| Remote URL | none |
| Needs API key | yes |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Other |
| Latest release | v3.2.35 (Oct 24, 2026) |
| Last commit | Oct 24, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "harness-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "harness-mcp-v2"
      ],
      "env": {
        "HARNESS_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env HARNESS_API_KEY=your-value --transport stdio harness-mcp-server -- npx -y harness-mcp-v2
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "harness-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "harness-mcp-v2"
      ],
      "env": {
        "HARNESS_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "harness_api_key",
      "description": "HARNESS_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "harness-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "harness-mcp-v2"
      ],
      "env": {
        "HARNESS_API_KEY": "${input:harness_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `HARNESS_API_KEY` (secret): Shown in the README's example configuration.
- `PATH`: Shown in the README's example configuration.

## Tools

- `harness_describe`: Discover available resource types, operations, and fields. No API call — returns local registry metadata.
- `harness_schema`: Fetch exact YAML/JSON Schema definitions and examples for creating/updating resources.
- `harness_list`: List resources of a given type with filtering, search, and pagination.
- `harness_get`: Get a single resource by its identifier.
- `harness_create`: Create a new resource. Supports inline and remote (Git-backed) pipelines. Prompts for user confirmation via elicitation.
- `harness_update`: Update an existing resource. Supports inline and remote (Git-backed) pipelines.
- `harness_delete`: Delete a resource. Prompts for user confirmation via elicitation. Destructive.
- `harness_execute`: Execute an action on a resource (run/retry pipeline, import pipeline from Git, toggle flag, sync app).
- `harness_search`: Search across Harness resource types with a single query. Uses semantic routing (local all-MiniLM-L6-v2 ONNX…
- `harness_diagnose`: Diagnose pipeline, connector, delegate, and gitopsapplication resources (aliases: execution -> pipeline, gitopsapp ->…
- `harness_status`: Get a real-time project health dashboard — recent executions, failure rates, and deep links.
- `branch`: build.type=branch, build.spec.branch=
- `pr_number`: build.type=PR, build.spec.number=
- `commit_sha`: build.type=commitSha, build.spec.commitSha=
- `body`: must be an object with a yaml field. Raw string bodies are rejected by the public harnessexecute schema.
- `body.yaml`: may be a YAML string or a JSON pipeline object; JSON is serialized to YAML before the request.

## Similar MCP servers

- [Flstudio MCP](https://appsgit.com/mcp-servers/flstudio-mcp): Control FL Studio with Claude: in-DAW mixing, diagnosis, routing, and composition. (111 stars, MIT)
- [AsoBeast](https://appsgit.com/mcp-servers/asobeast): App Store and Google Play ASO: keyword rankings, competitors, reviews, audits and an action queue. (108 stars, AGPL-3.0, official, needs API key)
- [MCP Juridico Brasil](https://appsgit.com/mcp-servers/mcp-juridico-brasil): Processos judiciais brasileiros via DataJud CNJ: consulta, andamentos, resumo e prazos em dias úteis. (120 stars, MIT)
- [MCP Bridge](https://appsgit.com/mcp-servers/mcp-bridge): Exposes silverbullet-ai tools from a SilverBullet space to MCP clients. (107 stars, AGPL-3.0, needs API key)
- [CHAP Coordinator](https://appsgit.com/mcp-servers/chap-coordinator): Auditable records of human decisions over AI agent work. (121 stars, Apache-2.0)
- [NVIDIA Elements](https://appsgit.com/mcp-servers/nvidia-elements): NVIDIA Elements UI design system and agent tools for AI/ML, robotics, and autonomous vehicles. (106 stars, Apache-2.0, official)

---

Canonical page: https://appsgit.com/mcp-servers/harness-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.