JJ Planner MCP Server
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.
JJ Planner MCP Server
An MCP (Model Context Protocol) server that connects AI agents (Cursor, Claude, etc.) to JJ Planner — a project management PWA. Agents can query, create, update, and delete projects, tasks, and schedules through this server.
Requirements
Node.js 22.x or higher
A valid JJ Planner API key (issued from JJ Planner settings page)
Related MCP server: Cold's MCP Server - Project Management System
Installation
Via npm (recommended):
npm install -g @vncy/jj-planner-mcpFrom source:
git clone https://github.com/Vince-Yi/-vncy-jj-planner-mcp.git
cd -vncy-jj-planner-mcp
npm install
npm run buildConfiguration
Copy .env.example to .env and fill in your credentials:
cp .env.example .envJJ_PLANNER_API_BASE_URL=https://your-backend-url.com
JJ_PLANNER_API_KEY=jjp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxVariable | Description |
| Base URL of the JJ Planner backend |
| API key in the format |
Registering with Cursor
Add the following to your Cursor mcp.json:
{
"mcpServers": {
"jj-planner": {
"command": "npx",
"args": ["-y", "@vncy/jj-planner-mcp"],
"env": {
"JJ_PLANNER_API_BASE_URL": "https://your-backend-url.com",
"JJ_PLANNER_API_KEY": "jjp_..."
}
}
}
}Registering with Claude Code
Add to your claude_desktop_config.json (or Claude Code MCP settings):
{
"mcpServers": {
"jj-planner": {
"command": "npx",
"args": ["-y", "@vncy/jj-planner-mcp"],
"env": {
"JJ_PLANNER_API_BASE_URL": "https://your-backend-url.com",
"JJ_PLANNER_API_KEY": "jjp_..."
}
}
}
}Available Tools
Projects
Tool | Required Args | Optional Args | Description |
| — | — | List all projects |
|
| — | Get project details |
Groups
Tool | Required Args | Optional Args | Description |
|
| — | List groups in a project |
Tasks
Tool | Required Args | Optional Args | Description |
|
| — | List tasks in a project |
|
| — | Get task details |
|
|
| Create a new task |
|
|
| Update a task |
|
| — | Delete a task |
Task status values: pending / in_progress / completed
Task progress: integer from 0 to 100
Schedules
Tool | Required Args | Optional Args | Description |
|
|
| List schedules (all or per task) |
|
|
| Create a new schedule |
|
|
| Update a schedule |
|
| — | Delete a schedule |
Date format: YYYY-MM-DD
Half-day values: AM / PM
Project Structure
jj-planner-mcp/
├── package.json
├── tsconfig.json
├── .env.example
└── src/
├── index.ts # MCP server entry point, tool registration, stdio transport
├── client.ts # axios instance with X-API-Key header and response unwrapping
└── tools/
├── projects.ts # list_projects, get_project
├── groups.ts # list_groups
├── tasks.ts # list_tasks, get_task, create_task, update_task, delete_task
└── schedules.ts # list_schedules, create_schedule, update_schedule, delete_scheduleScripts
Command | Description |
| Compile TypeScript to |
| Run the compiled server |
| Run directly with ts-node (development) |
Authentication
Every request to the JJ Planner backend includes the following header:
X-API-Key: <your-api-key>The API key can be generated from the JJ Planner settings page. It follows the format jjp_ followed by 64 hexadecimal characters (68 characters total).
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
Read and manage To-do Calendar todos, schedules and tags from an AI agent.
A graph-based task manager your agent can read and update: tasks, dependencies, blockers.
Project management MCP for AI agents with safe task reads and writes.
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with the Just Plan It (JPI) job scheduling and resource management system through 69 MCP tools covering full CRUD operations for jobs, tasks, templates, components, and resources.69MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to create, manage, and track projects with associated todos, including CRUD operations and filtering by status, priority, and project.-
- AlicenseBqualityCmaintenanceExposes the Deferno task-manager backend to AI agents, enabling them to read, create, update, and manage tasks, habits, chores, events, and daily plans.81MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage personal project schedules through natural language, including creating and updating projects and tasks, tracking todos, querying schedules, and receiving reminders for deadlines and overdue items.-