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
2

What can you do with Jira Sprint Dashboard?

  • Check OAuth authentication status — Verify whether your current Jira session is authenticated using oauth_status.
  • Launch browser-based OAuth login — Start the Atlassian OAuth flow to authenticate with Jira via start_oauth.
  • Test the Jira connection — Confirm that authentication and network connectivity to Jira are working with test_jira_connection.
  • Retrieve a specific issue — Fetch full details for a single Jira issue by key using jira_get_issue.
  • Search issues with JQL — Run custom JQL queries to find issues across projects via jira_search.
  • List accessible projects — Get a list of all Jira projects available to the authenticated user with list_projects.

Documentation

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.