# Jira MCP Server
MCP (Model Context Protocol) server for Jira integration. Allows Claude Code (or any MCP client) to interact with your Jira tasks.
## Features
- ✅ **Get your tasks** - Fetch tasks assigned to you, filtered by project and status
- ✅ **Get task details** - Get detailed information about specific tasks
- ✅ **Create tasks** - Create new Jira tasks with description and issue type
## Prerequisites
- Node.js 18+
- Jira account with API access
- Jira API token
## Setup
### 1. Clone and Install
```bash
git clone <your-repo-url>
cd jira-mcp-server
npm install
```
### 2. Get Jira API Token
1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
2. Click "Create API token"
3. Give it a name (e.g., "MCP Server")
4. Copy the token (you won't see it again!)
### 3. Get Your Account ID
```bash
curl -u your-email@example.com:your-api-token \
https://cryptobplatform.atlassian.net/rest/api/3/myself | jq .accountId
```
Or open in browser (after logging in):
https://cryptobplatform.atlassian.net/rest/api/3/myself
### 4. Configure Environment Variables
Create `.env` file (or configure in Claude Code):
```bash
cp .env.example .env
# Edit .env with your credentials
```
## Usage with Claude Code
### Configuration
Add to your Claude Code config (usually `~/.config/claude/config.json` or similar):
```json
{
"mcpServers": {
"jira": {
"command": "node",
"args": ["/absolute/path/to/jira-mcp-server/index.js"],
"env": {
"JIRA_BASE_URL": "https://cryptobplatform.atlassian.net",
"JIRA_EMAIL": "andreu.slynchyk@gmail.com",
"JIRA_API_TOKEN": "your-api-token-here",
"JIRA_ASSIGNEE_ACCOUNT_ID": "6148ce85071141006ab17eb7"
}
}
}
}
```
### Example Prompts for Claude Code
Once configured, you can ask Claude Code:
```
"Show me my current tasks in ART project"
"Get details about task ART-114"
"Create a new task in ART: Fix login bug"
"What tasks are in progress?"
```
## Available Tools
### 1. `get_my_tasks`
Get your Jira tasks filtered by project and status.
**Parameters:**
- `projectKey` (string, optional) - Project key (default: "ART")
- `status` (string, optional) - Task status (default: "In Progress")
**Example:**
```javascript
{
"projectKey": "ART",
"status": "In Progress"
}
```
### 2. `get_task_details`
Get detailed information about a specific task.
**Parameters:**
- `issueKey` (string, required) - Task key (e.g., "ART-114")
**Example:**
```javascript
{
"issueKey": "ART-114"
}
```
### 3. `create_task`
Create a new Jira task.
**Parameters:**
- `projectKey` (string, required) - Project key
- `summary` (string, required) - Task title
- `description` (string, optional) - Task description
- `issueType` (string, optional) - Issue type: "Задача", "Баг", "История" (default: "Задача")
**Example:**
```javascript
{
"projectKey": "ART",
"summary": "Fix authentication issue",
"description": "Users cannot login with OAuth",
"issueType": "Баг"
}
```
## Testing Locally
You can test the server directly:
```bash
npm start
```
Then send a JSON-RPC request via stdin:
```bash
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node index.js
```
## Troubleshooting
### Authentication Error
Make sure your API token is correct and your email matches your Jira account.
### "Task not found" Error
Check that:
1. The task key is correct (e.g., "ART-114" not "art-114")
2. You have permission to view the task
3. The project key is correct
### Environment Variables Not Loading
When using with Claude Code, make sure to set environment variables in the `mcpServers` config, not in a `.env` file.
## Project Structure
```
jira-mcp-server/
├── index.js # Main MCP server implementation
├── package.json # Dependencies and scripts
├── .env.example # Example environment variables
└── README.md # This file
```
## Security Notes
⚠️ **Never commit your API token to git!**
Add to `.gitignore`:
```
.env
node_modules/
```
## License
MIT
## Author
andreu slynchyk (andreu.slynchyk@gmail.com)
