Codacy MCP Server

What is Codacy MCP Server?

The Codacy MCP Server is a Model Context Protocol server that connects to the Codacy API, providing access to repository management, code quality, coverage, security, and analysis tools. It is designed for developers using AI‑powered IDEs such as Cursor, Windsurf, VS Code with Copilot, or Claude Desktop.

How to use Codacy MCP Server?

Install Node.js and ensure npx works. Obtain a Codacy Account API Token from your Codacy account. Then configure the server in your IDE (e.g., Cursor, Windsurf, VS Code, Claude Desktop) by adding a JSON configuration or using the one‑click install links. The server runs via npx -y @codacy/codacy-mcp with the token set as the CODACY_ACCOUNT_TOKEN environment variable.

Key features of Codacy MCP Server

• Repository setup and management (add/follow repos)
• Organization and repository listing with pagination
• Code quality issue listing and filtering (severity, category, language, author, branch)
• File analysis (issues, coverage, duplication, detailed metrics)
• Security analysis via SRM items (SAST, secrets, SCA, IaC, CICD, DAST, pentesting)
• Pull request analysis (issues, coverage diffs, Git diff)
• Tool and pattern management (list, get definitions, patterns)
• Local CLI analysis (run Codacy CLI on files or directories)

Use cases of Codacy MCP Server

• Perform code quality audits and technical debt assessments
• Check style guide compliance and investigate performance issues
• Scan for security vulnerabilities across an organization or repository
• Analyze pull request diffs for new issues and coverage changes
• Run local quality analysis without waiting for scheduled scans

FAQ from Codacy MCP Server

What are the runtime requirements?

The server requires git, Node.js (with npx working), and optionally the Codacy CLI for local analysis. The CLI will be auto‑installed if missing.

How do I get a Codacy API token?

Go to your Codacy Account and generate a Personal API Access Token. Set it as the CODACY_ACCOUNT_TOKEN environment variable.

How do I install the MCP Server in my IDE?

The easiest way is to install the Codacy extension from the IDE marketplace and click “Add Codacy MCP Server”. Alternatively, manually add a JSON configuration file (e.g., .cursor/mcp.json for Cursor, claude_desktop_config.json for Claude Desktop) with the npx command and your token.

What should I do if NPX doesn’t work with Claude Desktop and NVM?

Install the server globally (npm install -g @codacy/codacy-mcp) and configure the MCP server to use the Node binary directly, pointing to the installed dist/index.js.

Which analysis tools are available through the server?

The server provides tools for repository management, organization/repo listing, code quality issues, file analysis, security (SRM) items, pull request analysis, tool/pattern management, and local CLI analysis. Each tool is prefixed with codacy_.