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

Variable	Required	Description
GOOGLE_APPLICATION_CREDENTIALS	Yes	Path to Firebase Service Account Key JSON
FIREBASE_DATABASE_URL	Yes	Firebase Realtime Database URL
DEFAULT_USER_ID	No	Default Firebase Auth UID for operations
DEFAULT_USER_NAME	No	Default user display name

Available Tools (70+)

Category	Tools
Projects	create, list, get, update, delete, dashboard, summary
Sprints	create, list, get, update, delete, burndown, retrospective
Tasks	create, list, get, update, delete, search, assign, change status
Bugs	create, list, get, update, delete
Epics	create, list, get, update, delete, add/remove tasks
Proposals	create, list, get, update, delete, approve/reject
Comments	create, list, delete
Notifications	list, send, mark read, clear
Members	add, list, remove, change role
Invitations	send, list, accept, reject
Users	list, get, search
Analytics	project dashboard, developer workload, leaderboard
Planning	create full plan from document, create sprint plan
Templates	create, list, delete task templates
Workflows	create, list, update, delete, toggle automation rules
Time Tracking	create, list, delete time entries
Saved Views	create, list, delete custom views
Achievements	list, evaluate user achievements
Standup	get daily standup data

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