Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@JJ Planner MCP Server List all my projects"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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
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 buildCopy .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 |
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_..."
}
}
}
}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_..."
}
}
}
}Tool | Required Args | Optional Args | Description |
| — | — | List all projects |
|
| — | Get project details |
Tool | Required Args | Optional Args | Description |
|
| — | List groups in a project |
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
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
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_scheduleCommand | Description |
| Compile TypeScript to |
| Run the compiled server |
| Run directly with ts-node (development) |
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).
MIT
This server cannot be deployed
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.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
