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 MCP Server with OAuthsearch for open bugs in project ABC using JQL"
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.
Jira MCP Server with OAuth Authentication
π Smithery-Compatible MCP Server for seamless Jira integration with browser OAuth authentication.
β¨ Key Features
π Browser OAuth Flow - No manual API token management
πͺ Smithery Marketplace Ready - One-click installation
β‘ Auto-Configuration - Claude Desktop configured automatically
π οΈ Complete Tool Suite - Issue management, search, projects
π Secure - OAuth tokens handled safely
π± User-Friendly - Config UI in Smithery
π― User Experience
Installation Flow:
Install from Smithery marketplace
Configure Jira URL and email in Smithery UI
Open Claude Desktop (auto-configured)
Run
start_oauthtoolLogin via browser
Ready! All Jira tools available
π οΈ Available Tools
oauth_status- Check authentication statusstart_oauth- Launch browser authenticationtest_jira_connection- Verify connectionjira_get_issue- Get issue detailsjira_search- Search with JQLlist_projects- List accessible projectshelp- Complete usage guide
π Deployment
For Smithery Marketplace:
Upload this repository to Smithery
Configure OAuth app with Atlassian
Set environment variables in Smithery
Publish to marketplace
OAuth App Setup:
Authorization callback URL:
${SMITHERY_HOSTNAME}/oauth/callbackScopes:
read:jira-user,read:jira-work,write:jira-work
π» Development
π Environment Variables
Required for Smithery deployment:
π§ Technical Details
Runtime: Node.js 18+
Transport: HTTP (Smithery-compatible)
Authentication: Atlassian OAuth 2.0
Framework: Express.js with MCP SDK
Token Storage: In-memory (production: Redis recommended)
π License
MIT License - see LICENSE file for details
Built for seamless Jira integration with Claude Desktop via Smithery marketplace.