jira-easy-mcp
io.github.IamSAL · Updated
Self-hosted Jira Server/Data Center 7-10 for AI agents with username + password. 42 tools.
At a glance
jira-easy-mcp is an MCP server in the Dev Tools & Git category. It runs locally over stdio via `npx -y jira-easy-mcp`, and needs JIRA_BASE_URL and JIRA_PASSWORD. It scores A (82/100) on the MCP Skills Hub health score as of Oct 28, 2026.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install jira-easy-mcp in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install jira-easy-mcp in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add jira-easy-mcp -e 'JIRA_BASE_URL=<JIRA_BASE_URL>' -e 'JIRA_PASSWORD=<JIRA_PASSWORD>' -- npx -y jira-easy-mcpFill in your credentials
Replace <JIRA_BASE_URL>, <JIRA_PASSWORD> with your real values. Keep secrets out of any config file you commit.
Verify it's connected
bashclaude mcp listSharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes. It discovers them automatically.
How to install jira-easy-mcp in Claude DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this server
json{ "mcpServers": { "jira-easy-mcp": { "command": "npx", "args": [ "-y", "jira-easy-mcp" ], "env": { "JIRA_BASE_URL": "<JIRA_BASE_URL>", "JIRA_PASSWORD": "<JIRA_PASSWORD>" } } } }Fill in your credentials
Replace <JIRA_BASE_URL>, <JIRA_PASSWORD> with your real values. Keep secrets out of any config file you commit.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install jira-easy-mcp in CursorAI-first code editor
Create / edit .cursor/mcp.json in your project
json{ "mcpServers": { "jira-easy-mcp": { "command": "npx", "args": [ "-y", "jira-easy-mcp" ], "env": { "JIRA_BASE_URL": "<JIRA_BASE_URL>", "JIRA_PASSWORD": "<JIRA_PASSWORD>" } } } }Fill in your credentials
Replace <JIRA_BASE_URL>, <JIRA_PASSWORD> with your real values. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install jira-easy-mcp in Codex CLIOpenAI coding agent
Add to ~/.codex/config.toml
toml[mcp_servers.jira-easy-mcp] command = "npx" args = ["-y", "jira-easy-mcp"] env = { JIRA_BASE_URL = "<JIRA_BASE_URL>", JIRA_PASSWORD = "<JIRA_PASSWORD>" }Fill in your credentials
Replace <JIRA_BASE_URL>, <JIRA_PASSWORD> with your real values. Keep secrets out of any config file you commit.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install jira-easy-mcp in WindsurfCodeium's agentic IDE
Edit ~/.codeium/windsurf/mcp_config.json
json{ "mcpServers": { "jira-easy-mcp": { "command": "npx", "args": [ "-y", "jira-easy-mcp" ], "env": { "JIRA_BASE_URL": "<JIRA_BASE_URL>", "JIRA_PASSWORD": "<JIRA_PASSWORD>" } } } }Fill in your credentials
Replace <JIRA_BASE_URL>, <JIRA_PASSWORD> with your real values. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install jira-easy-mcp in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
Add the server
json{ "mcpServers": { "jira-easy-mcp": { "command": "npx", "args": [ "-y", "jira-easy-mcp" ], "env": { "JIRA_BASE_URL": "<JIRA_BASE_URL>", "JIRA_PASSWORD": "<JIRA_PASSWORD>" } } } }Fill in your credentials
Replace <JIRA_BASE_URL>, <JIRA_PASSWORD> with your real values. Keep secrets out of any config file you commit.
How to install jira-easy-mcp in VS CodeCopilot / MCP support
Create .vscode/mcp.json
json{ "servers": { "jira-easy-mcp": { "type": "stdio", "command": "npx", "args": [ "-y", "jira-easy-mcp" ], "env": { "JIRA_BASE_URL": "<JIRA_BASE_URL>", "JIRA_PASSWORD": "<JIRA_PASSWORD>" } } } }Fill in your credentials
Replace <JIRA_BASE_URL>, <JIRA_PASSWORD> with your real values. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What does jira-easy-mcp need from you?
API key — Jira password (optional if stored in the OS keychain under JiraMCP)
JIRA_BASE_URLrequiredEnvironment variableJira Server/Data Center URL, including any context path (e.g. https://jira.example.com/jira)
JIRA_USERNAMEoptionalEnvironment variableJira username (optional if stored in the OS keychain under JiraMCP)
JIRA_PASSWORDoptionalsecretEnvironment variableJira password (optional if stored in the OS keychain under JiraMCP)
JIRA_PROJECTS_FILTERoptionalEnvironment variableComma-separated project keys the agent may access
JIRA_SSL_VERIFYoptionalEnvironment variableSet to false to skip TLS verification (prefer NODE_EXTRA_CA_CERTS)
Pass secrets through your shell environment rather than committing them into a config file.
What tools does jira-easy-mcp expose?
This server runs as a local package. We only query remote servers for their tool list — asking this one would mean executing it, so its tools are listed in the documentation below.
What the code can do
Read from the published package source — never executed. Parsed 23 of 23 source files.
This server can run other programs on your machine, read and write files and make network requests.
How it was published
- Published by a verified CI identity (github trusted publishing) rather than a personal token.
- Has a provenance attestation tying this artifact to the commit it was built from.
- 1 npm maintainer — a single point of compromise · last published by GitHub Actions.
Maintainer of this package and think something here is wrong? Tell us and we'll correct it.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
- Downloads at launch — The package is fetched from its registry each run unless you pin a version.
- Last commit 2 days ago — Actively maintained.
- 4 GitHub stars — Very little community usage so far.
- 89 weekly downloads — Very few installs — you would be an early user.
Client compatibility
Health score
A · 82Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%100%
Last commit 2 days ago.
- Adoption20%33%
4 stars, 89 weekly downloads.
- Transparency20%75%
3/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✗ discoverable tool list.
- Provenance15%100%
Package and registry entry point at the same repository.
- Packaging15%100%
Publishes a pinned version (2.0.1).
Documentation
Full READMEjira-easy-mcp
Another Model Context Protocol (MCP) server for Jira, without Auth token. Provides tools for complete Jira automation including issues, projects, boards, sprints, comments, worklogs, and more.
Tested on: Jira Server / Data Center 7.13, 8.20, 9.12 and 10.3 (every tool, automated, see Development & Testing)
🔑 Why This MCP?
Works with Basic Authentication (username + password) — no API tokens required!
Most Jira MCP servers require OAuth or API tokens, which many organizations restrict or don't allow. This MCP uses HTTP Basic Authentication, so you can connect using just your Jira username and password. Perfect for:
- 🏢 Enterprise environments where admins don't allow API token creation
- 🔒 Self-hosted Jira Server instances without OAuth configured
- ⚡ Quick setup without going through IT approval processes
Quick Start
VS Code (Workspace Configuration)
Create .vscode/mcp.json in your workspace root:
{
"servers": {
"jira": {
"type": "stdio",
"command": "npx",
"args": ["-y", "jira-easy-mcp"],
"env": {
"JIRA_BASE_URL": "https://your-jira-instance.com",
"JIRA_USERNAME": "your-username",
"JIRA_PASSWORD": "your-password",
"JIRA_PROJECTS_FILTER": "ABC,DEF,XYZ",
"JIRA_RESPONSE_FORMAT": "JSON"
}
}
}
}Add to your VS Code settings for accessing in all workspaces.
Excerpt — the full document is on GitHub.
Alternatives to jira-easy-mcp
- agent-tools (x402 + MCP + A2A directory)B · 78Discover x402 services, MCP servers and A2A agents by intent — agent-tools.cloud directory.
- KatanA Markdown LinterB · 71Markdown linter, workspace-scoped stdio MCP server, and self-hosted text-only remote MCP server.
- EverythingA · 88Reference and test server exercising every MCP feature — prompts, resources, tools and sampling. Useful for building your own.
- Gmail-MCP-ServerA · 87Lean Gmail MCP server with auto authentication support
Maintain jira-easy-mcp? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/io-github-iamsal-jira-easy-mcp)Catalog data refreshed . Something wrong? Report it.