Jira Sprint Dashboard

Generates interactive sprint analytics and executive dashboards by connecting Jira data to Claude AI. Provides insights on burndown, velocity, and goal progress.

GitHub

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.

Related Servers