jira-mcp
Provides tools for managing Jira issues, comments, workflows, time tracking, and project configuration via the Jira API, with support for multi-instance routing, Atlassian Document Format (ADF) conversion, task caching, and comment templates.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@jira-mcpupdate task PROJ-123 status to In Progress"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SoftSpark Atlassian MCP
Two MCP servers for Atlassian Cloud: Jira and Confluence. One configuration, one API token, separate tool lists.
Packages
Package | What it does | Docs |
Jira: sync, search, comment, transition, log time, reassign, create and delete issues | ||
Confluence Cloud: pages, blog posts, footer and inline comments, labels, attachments, restrictions, whiteboards | ||
| Shared config, ADF conversion, HTTP transport, MCP envelope. Not published — bundled into both servers at build time | — |
Related MCP server: Jira MCP Server
Why two servers and not one
One Atlassian site serves both products from the same host with the same API token, so they share a configuration file and a transport layer. They do not share a tool list.
Merging them would put near-homonyms in one list: search_tasks beside search_pages, get_task_details beside get_page, add_task_comment beside add_page_comment. That measurably worsens tool selection, and the failure is silent — the wrong tool returns a plausible answer about the wrong product. packages/core/tests/tool-name-collisions.test.ts asserts the two lists never overlap.
Install whichever you need, or both.
Install
npm install -g @softspark/jira-mcp @softspark/confluence-mcpjira-mcp config init
jira-mcp config set-credentials # shared by both servers
jira-mcp config add-project KAN https://your-site.atlassian.net
confluence-mcp space add DOCS https://your-site.atlassian.netRegister in an MCP client:
{
"mcpServers": {
"jira": { "command": "jira-mcp" },
"confluence": { "command": "confluence-mcp" }
}
}All state lives in ~/.softspark/jira-mcp/, the standard config directory for SoftSpark tools. The directory keeps its original name: renaming it would orphan every existing installation.
Development
npm install # links the workspace
npm run typecheck # tsc across all packages
npm run lint
npm test # one run across the whole workspace
npm run test:coverage # 70% gate
npm run build # builds both published packagesTests run workspace-wide on purpose. core has no consumers of its own, so a change there is only meaningful if both servers still pass; a per-package run would let a core change break a server with no single command noticing.
Pre-commit gate:
npm run typecheck && npm run lint && npm test && npm run buildDocumentation
CHANGELOG — shared; both packages release together under one version.
kb/reference/— architecture, api, adf, caching, configuration, templates, confluence.kb/howto/— setup, multi-instance, cli-usage.kb/procedures/— sop-pre-commit, sop-release, sop-post-release-testing.
Contributing
See CONTRIBUTING, SECURITY and the Code of Conduct.
License
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
MCP server for Support & Service Management
MCP Server for JFrog, providing tools for development and artifact management.
MCP server for Product Management
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables interaction with Jira to fetch issues by key and perform JQL searches. It provides a foundation for integrating multiple work systems, with planned support for Slack and GitHub.493MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for integrating with Jira Server instances, enabling natural language interactions to create, update, search, and manage issues and comments.371MIT
- AlicenseNot gradedqualityCmaintenanceProduction-ready MCP server for Atlassian Jira and Confluence, providing tools for issue management, page retrieval, and content operations.261MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for JIRA integration enabling issue management, search, comments, and linking via natural language.Apache 2.0