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.