Skip to main content
Glama

mcp-jira-stdio

MCP Jira Server

A Model Context Protocol (MCP) server for Jira API integration. Enables reading, writing, and managing Jira issues and projects directly from your MCP client (e.g., Claude Desktop).

🚀 Quick Start

1. Prerequisites

  • Node.js v18 or higher
  • Jira instance (Cloud or Server)
  • Jira API token

2. Installation

# Install from npm npm install -g mcp-jira-stdio # Or install locally in your project npm install mcp-jira-stdio
Development Installation
# Clone the repository git clone https://github.com/freema/mcp-jira-stdio.git cd mcp-jira-stdio # Install dependencies npm install # or using Task runner task install # Build the project npm run build # or task build

3. Jira API Setup

  1. Go to your Jira instance settings
  2. Create an API token:
    • Jira Cloud: Go to Account Settings → Security → Create and manage API tokens
    • Jira Server: Use your username and password (or create an application password)
  3. Note your Jira base URL (e.g., https://yourcompany.atlassian.net)

4. Configuration

Create a .env file from the provided example:

# Copy the example environment file cp .env.example .env # Edit .env with your actual Jira credentials # Or use Task runner: task env

Example .env contents:

JIRA_BASE_URL=https://your-instance.atlassian.net JIRA_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-token

Note: Generate your API token at https://id.atlassian.com/manage-profile/security/api-tokens

5. Test Connection

# Test Jira connection task jira:test # List visible projects task jira:projects

6. Configure MCP Client

Add to your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/claude/claude_desktop_config.json
{ "mcpServers": { "jira": { "command": "mcp-jira-stdio", "env": { "JIRA_BASE_URL": "https://your-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token" } } } }
Alternative: Using npx
{ "mcpServers": { "jira": { "command": "npx", "args": ["mcp-jira-stdio"], "env": { "JIRA_BASE_URL": "https://your-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token" } } } }

Restart Claude Desktop after adding the configuration.

📦 Available Tools

Projects

  • jira_get_visible_projects: Retrieves all projects visible to the user.
  • jira_get_project_info: Retrieves detailed information about a project (components, versions, roles, insights).

Issues

  • jira_get_issue: Retrieve issue details by key (supports optional fields/expand).
  • jira_search_issues: Search for Jira issues using JQL with pagination and fields.
  • jira_create_issue: Create a new issue in a project (type, priority, assignee, labels, components).
  • jira_update_issue: Update an existing issue (summary, description, priority, assignee, labels, components).
  • jira_create_subtask: Create a subtask under a parent issue (auto-detects subtask type).

Comments

  • jira_add_comment: Add a comment to an issue (optional visibility by group/role).

Metadata & Users

  • jira_get_issue_types: List issue types (optionally per project).
  • jira_get_users: Search for users (by query, username, or accountId).
  • jira_get_priorities: List available priorities.
  • jira_get_statuses: List available statuses (global or project-specific).

My Work

  • jira_get_my_issues: Retrieve issues assigned to the current user (sorted by updated).

🛠️ Development

Development Commands

# Development mode with hot reload npm run dev task dev # Build for production npm run build task build # Type checking npm run typecheck task typecheck # Linting npm run lint task lint # Format code npm run format task fmt # Run all checks npm run check task check

MCP Inspector

Debug your MCP server using the inspector:

# Run inspector (production build) npm run inspector task inspector # Run inspector (development mode) npm run inspector:dev task inspector:dev

Testing

# Run tests npm test task test # Run tests with coverage npm run test:coverage task test:coverage # Watch mode npm run test:watch task test:watch

📋 Project Structure

src/ ├── index.ts # Entry point & MCP server setup ├── config/ │ └── constants.ts # API configuration & constants ├── tools/ │ ├── index.ts # Tool exports │ └── get-visible-projects.ts # Get visible projects tool ├── types/ │ ├── common.ts # Common types & interfaces │ ├── jira.ts # Jira API types │ └── tools.ts # Tool input/output schemas └── utils/ ├── jira-auth.ts # Jira authentication & client ├── validators.ts # Input validation with Zod ├── formatters.ts # Response formatting ├── error-handler.ts # Error handling └── api-helpers.ts # Jira API helpers

🔧 Tool Usage Examples

Get Visible Projects

// List all projects jira_get_visible_projects({}); // List projects with additional details jira_get_visible_projects({ expand: ['description', 'lead', 'issueTypes'], }); // List recent projects only jira_get_visible_projects({ recent: 10, });

❗ Troubleshooting

Common Issues

"Authentication failed"

  • Verify your API token is correct
  • Check that your email matches your Jira account
  • Ensure your Jira base URL is correct (no trailing slash)

"Connection failed"

  • Verify your Jira instance is accessible
  • Check network connectivity
  • Ensure Jira REST API is enabled

"Permission denied"

  • Verify your account has the necessary permissions
  • Check project permissions in Jira
  • Ensure you're using the correct Jira instance

MCP Connection Issues

  • Ensure you're using the built version (dist/index.js)
  • Check that Node.js path is correct in Claude Desktop config
  • Look for errors in Claude Desktop logs
  • Use task inspector to debug

Debug Commands

# Test Jira connection task jira:test # List projects (test API connectivity) task jira:projects # Run MCP inspector for debugging task inspector:dev # Check all configuration task check

🔍 Environment Variables

VariableRequiredDescriptionExample
JIRA_BASE_URLYesJira instance URLhttps://company.atlassian.net
JIRA_EMAILYesYour Jira emailuser@example.com
JIRA_API_TOKENYesJira API tokenATxxx...
NODE_ENVNoEnvironment modedevelopment or production

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Run tests and linting (task check)
  4. Commit your changes (git commit -m 'Add some amazing feature')
  5. Push to the branch (git push origin feature/amazing-feature)
  6. Open a Pull Request

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

MCP Config Setup

Configure Claude Desktop to use this MCP server interactively:

npm run setup:mcp

The script will:

  • Build the project if needed and detect your Node path
  • Prompt for JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN
  • Save a jira entry into your Claude Desktop config or print the JSON
  • Optionally generate a local .env for development
-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

MCP server for Jira integration with stdio transport. Enables reading, writing, and managing Jira issues and projects directly from Claude Desktop. Supports issue creation, updates, comments, JQL search, and project management.

  1. 🚀 Quick Start
    1. 1. Prerequisites
    2. 2. Installation
    3. 3. Jira API Setup
    4. 4. Configuration
    5. 5. Test Connection
    6. 6. Configure MCP Client
  2. 📦 Available Tools
    1. Projects
    2. Issues
    3. Comments
    4. Metadata & Users
    5. My Work
  3. 🛠️ Development
    1. Development Commands
    2. MCP Inspector
    3. Testing
  4. 📋 Project Structure
    1. 🔧 Tool Usage Examples
      1. Get Visible Projects
    2. ❗ Troubleshooting
      1. Common Issues
      2. Debug Commands
    3. 🔍 Environment Variables
      1. 🤝 Contributing
        1. 📄 License
          1. MCP Config Setup

        Related MCP Servers

        • -
          security
          F
          license
          -
          quality
          A Model Context Protocol (MCP) server that enables interaction with JIRA APIs through Claude Desktop, allowing users to search, create, update, and manage JIRA issues using natural language commands.
          Last updated -
          • Linux
          • Apple
        • A
          security
          A
          license
          A
          quality
          A Model Context Protocol server that enables interaction with Jira's REST API using natural language commands, allowing users to manage Jira projects, issues, comments, and workflows through Claude Desktop and other MCP clients.
          Last updated -
          10
          1
          MIT License
        • A
          security
          A
          license
          A
          quality
          An MCP server that enables communication with Jira, allowing users to perform operations like getting, searching, creating, and editing issues through natural language interaction.
          Last updated -
          1
          13
          MIT License
        • -
          security
          A
          license
          -
          quality
          This project builds a read-only MCP server. For full read, write, update, delete, and action capabilities and a simplified setup, check out our free CData MCP Server for Jira Assets (beta): https://www.cdata.com/download/download.aspx?sku=KNZK-V&type=beta
          Last updated -
          MIT License
          • Apple
          • Linux

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/freema/mcp-jira-stdio'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server