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
Install from Smithery → Config UI → Browser Login → Done!
(30 seconds total setup time)
Installation Flow:
- Install from Smithery marketplace
- Configure Jira URL and email in Smithery UI
- Open Claude Desktop (auto-configured)
- Run
start_oauthtool - Login 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/callback - Scopes:
read:jira-user,read:jira-work,write:jira-work
💻 Development
# Install dependencies
npm install
# Build TypeScript
npm run build
# Start development server
npm run dev-oauth
# Test OAuth flow
npm run test-oauth
📋 Environment Variables
Required for Smithery deployment:
OAUTH_CLIENT_ID=your_atlassian_oauth_client_id
OAUTH_CLIENT_SECRET=your_atlassian_oauth_client_secret
THIS_HOSTNAME=https://your-smithery-hostname
PORT=3000
🔧 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.
