Jenkins

v1.0.0Developer Toolsstable

Enables comprehensive Jenkins automation through MCP interface, allowing users to manage builds, jobs, artifacts, and queues with natural language commands. Supports build triggering, monitoring, artifact retrieval, and system status checks with auto

jenkinsjenkins-mcpjenkins-mcp-serverjenkins-pipelinejenkinsfile
Share:
13
Stars
0
Downloads
0
Weekly
0/5

What is Jenkins?

Jenkins is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables comprehensive jenkins automation through mcp interface, allowing users to manage builds, jobs, artifacts, and queues with natural language commands. supports build triggering, monitoring, arti...

Enables comprehensive Jenkins automation through MCP interface, allowing users to manage builds, jobs, artifacts, and queues with natural language commands. Supports build triggering, monitoring, artifact retrieval, and system status checks with auto

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables comprehensive Jenkins automation through MCP interfa

Use Cases

Trigger builds, monitor jobs, and manage artifacts via natural language.
Automate CI/CD workflows with AI-powered Jenkins commands.
LicenseApache 2.0
Languagepython
Versionv1.0.0
UpdatedApr 14, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx jenkins-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Jenkins

Jenkins MCP Server is an enterprise-grade MCP integration for Jenkins CI/CD that lets AI assistants trigger builds, monitor job status, stream console logs, manage artifacts, and control the build queue through natural language. It connects to any Jenkins 2.401+ instance via the Jenkins API using username and API token authentication, with built-in support for CSRF protection, exponential retry logic, multi-tier caching, and both STDIO and HTTP transports. DevOps engineers and teams running Jenkins pipelines can use this server to ask Claude to kick off jobs, diagnose failures, fetch artifacts, or run batch operations across many jobs at once.

Prerequisites

  • Node.js 14.0.0 or higher and Python 3.12 or higher
  • A Jenkins 2.401+ instance accessible over the network
  • A Jenkins user account with an API token generated (User > Configure > API Token)
  • npm for installation
  • An MCP-compatible client such as Claude Desktop
1

Install the package globally via npm

Install the Jenkins MCP server package from npm. This makes the jenkins-mcp command available system-wide.

npm install -g @ashwinighuge/jenkins-mcp-server

# Verify installation
jenkins-mcp --help
2

Generate a Jenkins API token

Log into your Jenkins instance, click your username in the top-right, go to Configure, scroll to API Token, click Add new Token, generate it, and copy the value.

3

Set the required environment variables

Configure the three required variables: JENKINS_URL, JENKINS_USER, and JENKINS_API_TOKEN. These can go in a .env file or be passed directly in the MCP client config.

export JENKINS_URL="http://your-jenkins-server:8080"
export JENKINS_USER="your-username"
export JENKINS_API_TOKEN="your-api-token"
4

Configure your MCP client

Add the Jenkins MCP server to your Claude Desktop configuration file with the credentials as environment variables.

5

Test the connection and start using Jenkins tools

Once connected, you can trigger jobs, list jobs, get build status, stream console output, download artifacts, and manage the build queue. The server supports optional caching tuning via JENKINS_CACHE_* variables for high-load environments.

Jenkins Examples

Client configuration

Add the Jenkins MCP server to claude_desktop_config.json with your Jenkins credentials as environment variables.

{
  "mcpServers": {
    "jenkins": {
      "command": "jenkins-mcp",
      "env": {
        "JENKINS_URL": "http://your-jenkins-server:8080",
        "JENKINS_USER": "your-username",
        "JENKINS_API_TOKEN": "your-api-token"
      }
    }
  }
}

Prompts to try

Example prompts that interact with Jenkins jobs, builds, and artifacts through the MCP server.

- "List all Jenkins jobs and show which ones failed in the last build"
- "Trigger the 'deploy-production' job and monitor it until it completes"
- "Show me the console output from the last failed build of 'backend-tests'"
- "List all artifacts from build #42 of the 'release-pipeline' job"
- "How many jobs are currently in the build queue and what are they waiting for?"

Troubleshooting Jenkins

Authentication fails with a 403 Forbidden error from Jenkins

Jenkins may have CSRF protection enabled that requires a crumb token. The server handles CSRF automatically, but verify JENKINS_USER and JENKINS_API_TOKEN are correct. Note that Jenkins API tokens are different from passwords — generate a dedicated token under User > Configure > API Token, not your login password.

The jenkins-mcp command is not found after npm install

The global npm bin directory may not be on your PATH. Run 'npm config get prefix' to find the global prefix, then ensure <prefix>/bin is in your PATH. On macOS with nvm this is often ~/.nvm/versions/node/<version>/bin.

Build triggers succeed but status monitoring times out or returns stale data

The server uses a multi-tier cache with short TTLs for dynamic data (30 seconds for build status). If you need real-time data, the cache settings can be tuned via JENKINS_CACHE_DYNAMIC_TTL and JENKINS_CACHE_SHORT_TTL environment variables set to lower values.

Frequently Asked Questions about Jenkins

What is Jenkins?

Jenkins is a Model Context Protocol (MCP) server that enables comprehensive jenkins automation through mcp interface, allowing users to manage builds, jobs, artifacts, and queues with natural language commands. supports build triggering, monitoring, artifact retrieval, and system status checks with auto It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Jenkins?

Follow the installation instructions on the Jenkins GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Jenkins?

Jenkins works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Jenkins free to use?

Yes, Jenkins is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "jenkins-mcp-server": { "command": "npx", "args": ["-y", "jenkins-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Jenkins?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides