planning-task-mcp

MCP Server for full autonomous project management. Manage projects, sprints, tasks, bugs, proposals, and more — all from your AI coding assistant.

Works with Claude Code, Claude Desktop, Codex (OpenAI), Gemini CLI, Cursor, Windsurf, and VS Code Copilot.

Features

• Projects, sprints, and task management with User Stories
• Bug tracking and proposals
• Team collaboration (members, invitations, comments, notifications)
• Sprint planning from natural language documents
• Analytics dashboards and burndown charts
• Achievements and gamification
• Workflow automation rules
• Time tracking and retrospectives

Prerequisites

• Node.js >= 18
• A Firebase project with Realtime Database enabled
• A Firebase Service Account Key (JSON file)

Install

npm install -g planning-task-mcp

Setup

After installing, run the interactive setup:

planning-task-mcp-setup

This will:

1. Ask for your Firebase Service Account Key path
2. Configure your Firebase Database URL
3. Set your default user ID and name
4. Auto-register the MCP in all detected AI clients (Claude Code, Codex, Gemini, Cursor, etc.)
5. Configure auto-approve permissions where supported

CLI mode (non-interactive)

planning-task-mcp-setup \
  --sa-key /path/to/serviceAccountKey.json \
  --db-url https://your-project-default-rtdb.firebaseio.com \
  --user-id your-firebase-uid \
  --user-name "Your Name"

Manual configuration

If you prefer to configure manually, add this to your MCP client config:

Claude Code (~/.mcp.json):

{
  "mcpServers": {
    "planning-task-mcp": {
      "command": "planning-task-mcp",
      "args": [],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/serviceAccountKey.json",
        "FIREBASE_DATABASE_URL": "https://your-project-default-rtdb.firebaseio.com",
        "DEFAULT_USER_ID": "your-uid",
        "DEFAULT_USER_NAME": "Your Name"
      }
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.planning-task-mcp]
command = "planning-task-mcp"
args = []

[mcp_servers.planning-task-mcp.env]
GOOGLE_APPLICATION_CREDENTIALS = "/path/to/serviceAccountKey.json"
FIREBASE_DATABASE_URL = "https://your-project-default-rtdb.firebaseio.com"
DEFAULT_USER_ID = "your-uid"
DEFAULT_USER_NAME = "Your Name"

Gemini CLI (~/.gemini/settings.json):

{
  "mcpServers": {
    "planning-task-mcp": {
      "command": "planning-task-mcp",
      "args": [],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/serviceAccountKey.json",
        "FIREBASE_DATABASE_URL": "https://your-project-default-rtdb.firebaseio.com",
        "DEFAULT_USER_ID": "your-uid",
        "DEFAULT_USER_NAME": "Your Name"
      }
    }
  }
}

Environment Variables

Available Tools (70+)

Usage

Once configured, just talk to your AI assistant:

• "Create a new project called MyApp"
• "Plan a sprint from this requirements document"
• "Show me the burndown chart for the current sprint"
• "Assign task T-123 to user X"
• "What's the developer workload for this sprint?"

License

MIT