@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 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:

{
  "mcpServers": {
    "planit": {
      "command": "npx",
      "args": ["-y", "@plan-it/mcp-server"],
      "env": {
        "PLANIT_API_TOKEN": "planit_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}

Claude Code:

claude mcp add planit -- npx -y @plan-it/mcp-server
export PLANIT_API_TOKEN="planit_pat_YOUR_TOKEN_HERE"

Cursor — Edit .cursor/mcp.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:

{
  "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:

{
  "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