npm package: @plan-it/mcp-server
Description: PlanIT MCP Server — manage issues, projects, and sprints from any AI tool
Latest version: 0.1.10

# @plan-it/mcp-server

**v0.1.4** — PlanIT MCP Server — manage issues, projects, and sprints from any AI tool.

## Quick Setup (60 seconds)

### 1. Create a token

Go to **[Settings → API](https://useplanit.com/settings/api)** and create a Personal Access Token with `read`, `write`, and `profile` scopes.

### 2. Add to your AI client

**Claude Desktop** — Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "planit": {
      "command": "npx",
      "args": ["-y", "@plan-it/mcp-server"],
      "env": {
        "PLANIT_API_TOKEN": "planit_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}
```

**Claude Code:**
```bash
claude mcp add planit -- npx -y @plan-it/mcp-server
export PLANIT_API_TOKEN="planit_pat_YOUR_TOKEN_HERE"
```

**Cursor** — Edit `.cursor/mcp.json`:
```json
{
  "mcpServers": {
    "planit": {
      "command": "npx",
      "args": ["-y", "@plan-it/mcp-server"],
      "env": {
        "PLANIT_API_TOKEN": "planit_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}
```

**VS Code** — Edit settings.json:
```json
{
  "mcp.servers": {
    "planit": {
      "command": "npx",
      "args": ["-y", "@plan-it/mcp-server"],
      "env": {
        "PLANIT_API_TOKEN": "planit_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}
```

**Antigravity** — Edit `~/.antigravity/mcp.json`:
```json
{
  "mcpServers": {
    "planit": {
      "command": "npx",
      "args": ["-y", "@plan-it/mcp-server"],
      "env": {
        "PLANIT_API_TOKEN": "planit_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}
```

### 3. Restart your AI client

That's it. Ask your AI: *"What issues do I have in PlanIT?"*

## Available Tools

| Tool | Description |
|------|-------------|
| `planit_list_issues` | List and filter issues (status, priority, assignee, project, team, search) |
| `planit_get_issue` | Get issue details (assignee, reporter, comments, contributors) |
| `planit_create_issue` | Create a new issue |
| `planit_update_issue` | Update issue fields |
| `planit_delete_issue` | Soft-delete (archive) an issue |
| `planit_search_issues` | Full-text search by title or identifier |
| `planit_list_projects` | List projects with health status |
| `planit_get_project` | Get project details with issues |
| `planit_create_project` | Create a new project |
| `planit_update_project` | Update project fields |
| `planit_list_iterations` | List iterations (sprints) |
| `planit_current_iteration` | Get active sprint with all issues |
| `planit_me` | Get your profile and organization memberships |

## Enum Values

**Issue Status:** `backlog`, `in-progress`, `in-review`, `done`, `cancelled`

**Issue Priority:** `urgent`, `high`, `medium`, `low`, `none`

**Project Health:** `on-track`, `at-risk`, `off-track`

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `PLANIT_API_TOKEN` | Yes | Personal Access Token from Settings → API |
| `PLANIT_ORGANIZATION_ID` | No | Override organization (defaults to your first org) |
| `PLANIT_API_BASE` | No | Override API base URL (for development) |

## Requirements

- Node.js 18+
- A PlanIT account with a Personal Access Token

## License

MIT