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:

1. Install from Smithery marketplace
2. Configure Jira URL and email in Smithery UI
3. Open Claude Desktop (auto-configured)
4. Run start_oauth tool
5. Login via browser
6. Ready! All Jira tools available

🛠️ Available Tools

• oauth_status - Check authentication status
• start_oauth - Launch browser authentication
• test_jira_connection - Verify connection
• jira_get_issue - Get issue details
• jira_search - Search with JQL
• list_projects - List accessible projects
• help - Complete usage guide

🚀 Deployment

For Smithery Marketplace:

1. Upload this repository to Smithery
2. Configure OAuth app with Atlassian
3. Set environment variables in Smithery
4. 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.