drio
Open app

Codecov MCP Server

Source

A Codecov Model Context Protocol server

Catalog onlyCatalog onlySTDIO

Overview

Codecov MCP Server is a server built in TypeScript that implements the Codecov Model Context Protocol, designed to help developers identify areas in their codebase that lack tests and suggest tests to write.

To use the Codecov MCP Server, run the command npx -y codecov-mcp-server --api-key XXX --git-url XXX in your terminal, replacing XXX with your actual Codecov API key and Git URL. You can also configure it to work with AI agents by adding the server configuration in JSON format.

  • Tools for retrieving coverage totals for specific commits. - Prompts for suggesting tests based on Codecov reports. - Easy installation and configuration using npx. - Debugging support through the MCP Inspector.
  1. Identifying untested areas in a codebase to improve test coverage.
  2. Automatically suggesting tests to write based on existing coverage reports.
  3. Integrating with AI tools to enhance development workflows.

Add to your AI client

Use these steps to connect Codecov MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "codecov-mcp-stedwick": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-codecov-mcp-stedwick"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "codecov-mcp-stedwick": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-codecov-mcp-stedwick"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "codecov-mcp-stedwick": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-codecov-mcp-stedwick"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "codecov-mcp-stedwick": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-codecov-mcp-stedwick"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "codecov-mcp-stedwick": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-codecov-mcp-stedwick"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "codecov-mcp-stedwick": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-codecov-mcp-stedwick"
      ]
    }
  }
}

FAQ

What programming language is Codecov MCP Server written in?

Codecov MCP Server is written in TypeScript.

Do I need to install anything to use Codecov MCP Server?

No, you can run it directly using `npx` without any installation.

How can I debug issues with the server?

You can use the MCP Inspector for debugging, which provides a URL to access debugging tools in your browser.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2661,"uuid":"d5764d58-4250-43f8-92bc-22460da2f409","name":"codecov-mcp","title":"Codecov MCP Server","description":"A Codecov Model Context Protocol server","avatar_url":"https://avatars.githubusercontent.com/u/63236?v=4","created_at":"2025-03-13T09:26:07.111Z","updated_at":"2025-03-13T09:39:06.105Z","status":"created","author_name":"stedwick","author_avatar_url":"https://avatars.githubusercontent.com/u/63236?v=4","tags":"mcp,codecov,mcp-server","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/stedwick/codecov-mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"3\",\"license\":\"\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-09 20:21:53\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools