Jira Weekly Reporter
About
Connects to a Jira instance to generate weekly reports based on issue activity.
Details
- Author
- jongryong
- Downloads
- 158
- Categories
- Productivity, Project Management, Automation, Other, Developer Tools
Jump to
- Connects securely via API tokens stored in a .env file.
- Exposes a generate_jira_report tool accessible over MCP.
- Defaults to issues updated in the last 7 days.
- Supports custom JQL queries and project‑specific filtering.
- Limits result count (configurable, default 50).
- Optionally requests a summary from the client’s LLM.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Jira Weekly ReporterCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Python 3.10+, fastmcp, and the listed dependencies. Create a .env file with JIRA_URL, JIRA_USERNAME, and JIRA_API_TOKEN. Run the server with python jira_reporter_server.py or fastmcp run jira_reporter_server.py. In an MCP client (e.g., Claude Desktop), invoke the generate_jira_report tool by name, optionally passing jql_query, project_key, max_results, or summarize parameters.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"jira weekly reporter": {
"jira_reporter": {
"command": "uv",
"args": [
"pip",
"install",
"fastmcp",
"jira[cli]",
"python-dotenv",
"httpx",
"anyio"
]
}
}
}
}McpServers
{
"jira_reporter": {
"command": "uv",
"args": [
"pip",
"install",
"fastmcp",
"jira[cli]",
"python-dotenv",
"httpx",
"anyio"
]
}
}Connects to a Jira instance to generate weekly reports based on issue activity.
- Jira Connection:Securely connects to Jira using API tokens stored in a.envfile.
- MCP Tool:Exposes agenerate_jira_reporttool accessible via the Model Context Protocol.
- Flexible Reporting:
- Defaults to reporting issues updated in the last 7 days.
- Allows specifying a custom JQL query.
- Can filter reports by a specific Jira project key.
- Limits the number of results returned (configurable).
- Python 3.10 or later.
- uv(recommended) orpipfor package management.
- Access to a Jira instance (Cloud, Server, or Data Center).
- A Jira API Token (Personal Access Token for Server/DC).
- FastMCP CLIinstalled and available in your system's PATH.
git clone https://github.com/Jongryong/jira_reporter.git cd jira_reporter
Install Dependencies:We recommend usinguv:
uv pip install fastmcp "jira[cli]" python-dotenv httpx anyio
pip install fastmcp "jira[cli]" python-dotenv httpx anyio
Create.envFile:Create a file named.envin thesame directoryasjira_reporter_server.py. Add your Jira connection details:
# .env JIRA_URL=https://your-domain.atlassian.net # Your Jira Cloud URL or Self-Hosted URL JIRA_USERNAME=your_email@example.com # Your Jira login email JIRA_API_TOKEN=your_api_token_or_pat # Your generated API Token or PAT
- Security:
- Never commit your.envfile to version control!Add.envto your.gitignorefile.
- Jira Cloud:Generate an API token from your Atlassian account settings:Manage API tokens.
- Jira Server/Data Center:Generate a Personal Access Token (PAT) from your Jira user profile settings:Using Personal Access Tokens.
You can run the server independently for testing or other purposes:
To run with SSE (e.g., for remote access):
fastmcp run jira_reporter_server.py --transport sse --port 8001
To make this server available as a tool within the Claude Desktop application:
-
Ensure Prerequisites:Make surefastmcpis installed and accessible in your system's PATH, as the configuration below uses thefastmcpcommand.
Locate Claude Config File:Find theclaude_desktop_config.jsonfile. Its location depends on your operating system:
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json(usuallyC:\Users\<YourUsername>\AppData\Roaming\Claude\claude_desktop_config.json)
- Linux:~/.config/Claude/claude_desktop_config.json(or$XDG_CONFIG_HOME/Claude/)
Edit the Config File:Openclaude_desktop_config.jsonin a text editor.
Add Server Configuration:Find the"mcpServers"object within the JSON (if it doesn't exist, create it as an empty object{}). Add the following entry insidemcpServers, making sure to replace"path/to/your/jira_reporter_server.py"with theabsolute pathto your script:
{ "mcpServers": { // ... other servers might be here ... "jira_report": { "command": "fastmcp", "args": [ "run", "/path/to/your/jira_reporter_server.py" // <-- IMPORTANT: Use the full, absolute path here ] } // ... other servers might be here ... } // ... rest of your Claude config ... }
- "jira_report": This is the internal name Claude uses. You can change it if desired.
- "command": "fastmcp": Tells Claude to use thefastmcpcommand-line tool.
- "args": [...]: Tells Claude to runfastmcp run /path/to/your/jira_reporter_server.py.
Save and Restart:Save theclaude_desktop_config.jsonfile and restart the Claude Desktop application.
Invoke the Tool:You should now be able to use the tool in Claude by mentioning the server name defined in the Python script (Jira Weekly Reporter). For example:@Jira Weekly Reporter generate jira report for project MYPROJ and summarize it
- Tool Name:generate_jira_report
- Description:Generates a report of Jira issues based on a JQL query (defaulting to recently updated). Optionally summarizes the report using the client's LLM.
TheFastMCPconstructor includesdependencies=["jira"]. This tells tools likefastmcp installthat thejiralibrary is required for this server to function correctly when creating isolated environments.
Contributions are welcome! Please feel free to submit issues or pull requests.
Interact with Jira to manage issues, projects, and workflows using the Jira Cloud Platform REST API.
An MCP server for interacting with the Jira API to manage projects, issues, and workflows.
About AI-powered Jira CLI and MCP server for humans and agents manage issues, sprints, boards with interactive wizards, multi-provider AI
An MCP server for managing Tempo worklogs in Jira. It connects to Jira and Tempo services using API tokens and environment variables.
MCP server for Xray test management plugin for Jira. Avoids the problem of slow Jira/ Xray combination. Can bring an entire test suite faster than manually adding. Can integrate AI testing as this is able to update test cases as well. Why MCP and not a skill? MCP communicates well with Atlassian MCP.
Official Atlassian MCP server for connecting AI agents to Jira, Confluence, Opsgenie, and other Atlassian products.
Perform queries and entity operations in your Fibery workspace.
Keep teams & agents coordinated automatically
Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.
A universal remote MCP server that connects to popular productivity tools such as Notion, Monday, AirTable, and many more.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
