planning-task-mcp
Provides full autonomous project management (projects, sprints, tasks, bugs, proposals, etc.) with data stored in Firebase Realtime Database.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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
Related MCP server: Trellis MCP
Prerequisites
Node.js >= 18
A Firebase project with Realtime Database enabled
A Firebase Service Account Key (JSON file)
Install
npm install -g planning-task-mcpSetup
After installing, run the interactive setup:
planning-task-mcp-setupThis will:
Ask for your Firebase Service Account Key path
Configure your Firebase Database URL
Set your default user ID and name
Auto-register the MCP in all detected AI clients (Claude Code, Codex, Gemini, Cursor, etc.)
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 |
| Yes | Path to Firebase Service Account Key JSON |
| Yes | Firebase Realtime Database URL |
| No | Default Firebase Auth UID for operations |
| 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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Project management shared by people and AI agents, with persistent project state through MCP.
MCP server for generating rough-draft project plans from natural-language prompts.
Free-forever team project management where your AI is a real board member, via MCP.
Work management where AI agents are first-class members: tasks, projects, memory over hosted MCP
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProject Management AI - MCP server providing AI-powered tools and automation by MEOK AI Labs7 npm41 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceA file-backed MCP server for hierarchical project management that enables AI assistants to create, claim, and complete tasks within a project→epic→feature→task structure, with dependency management and Markdown-based storage.MIT
- FlicenseNot gradedqualityCmaintenanceAn MCP server that automates project task breakdown, dependency management, and smart task recommendations, integrating with LLMs like Gemini and OpenAI.7-
- AlicenseNot gradedqualityBmaintenanceAgent-first project management MCP server that enables AI agents to manage tasks, spaces, lists, boards, subtasks, comments, and automations via natural language, with full audit trail and real-time sync.2MIT