Skip to content
appsgit

Harness 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.

github.com/harness/mcp-server (opens in a new tab)

Data as of from the GitHub API; description from the project's repository. Report an error

Install Harness MCP Server

Generated from the server's published package. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.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

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

Cursor

.cursor/mcp.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
{
  "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 Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
HARNESS_API_KEYsecretNoShown in the README's example configuration.
PATHNoShown in the README's example configuration.

Tools (16)

Parsed from the Tools section of the README; check the repository for the current list.

  • 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.

About Harness MCP Server

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.

  • harness
  • mcp-server
  • mcp

FAQ

Harness MCP Server FAQ

Still curious? Email info@appsgit.com.

How do I install the Harness MCP Server MCP server?

Add the command npx -y harness-mcp-v2 to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Harness MCP Server free?

The server is open source under the MIT license, so running it is free. It needs credentials (HARNESS_API_KEY) for the service it connects to, which may require a paid account.

Is Harness MCP Server actively maintained?

The most recent commit was on Oct 24, 2026. The latest release is v3.2.35, published Oct 24, 2026. appsgit only lists MCP servers with a commit in the last six months.