home / mcp / clj-kondo mcp server

clj-kondo MCP Server

Provides clj-kondo linting for Clojure files via MCP tool calls and configurable paths.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bigsy-clj-kondo-mcp": {
      "command": "npx",
      "args": [
        "clj-kondo-mcp"
      ]
    }
  }
}

This MCP server adds clj-kondo linting capabilities to your workflow for Clojure, ClojureScript, and EDN files. It enables automated analysis during editing or CI, helping you catch issues early even when you don’t have built-in linting in your environment.

How to use

You will run the MCP client to connect to a local or remote server that provides the clj-kondo linting tool. Use the lint_clojure tool to send file contents (or directories) and receive lint results. The tool accepts an absolute file path, an absolute directory, or a classpath string to lint the relevant Clojure files. You can optionally provide a specific configuration directory and adjust the lint level. The server runs as a separate process, so always provide absolute paths for file and configDir when you invoke lint commands.

How to install

Prerequisites you need before installation include Node.js and npm (or npx). Ensure you have a JavaScript runtime available on your system.

Step 1: Quick install via package runner and start the MCP server.

# Install the MCP server globally via npx and run it
npx clj-kondo-mcp

Manual installation

If you prefer to set up manually, follow these steps to build and run the server locally.

Step 1: Install dependencies

npm install

Step 2: Build the server

npm run build

Available tools

lint_clojure

Lint Clojure/ClojureScript/EDN content with configurable file input, optional configDir, and adjustable lint level.