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., "@HacknPlan MCP list 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.
Connect Claude directly to your HacknPlan game dev projects.
Log in to HacknPlan
Go to Profile → Settings → API Beta → Create
Name it (e.g. claude-mcp), select desired scopes, click Create
Copy the key
npm installAdd this to your claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"hacknplan": {
"command": "node",
"args": ["/absolute/path/to/hacknplan-mcp/index.js"],
"env": {
"HACKNPLAN_API_KEY": "your_api_key_here"
}
}
}
}Related MCP server: HAOps MCP Server
Tool | Description |
| List all projects in your workspace |
| Get project details |
| Create a new project ( |
| Partially update a project's name or description (PATCH) |
| Full replacement of a project (PUT) |
| Permanently delete a project |
| Archive (close) a project |
| Reopen a closed project |
| Get progress and burndown metrics for a project |
| Transfer project ownership to another user |
Tool | Description |
| List boards in a project (optionally include closed) |
| Get board details |
| Create a new board (optionally attach to a milestone) |
| Partially update a board (PATCH) |
| Full replacement of a board (PUT) |
| Permanently delete a board (optionally remove work items) |
| Archive (close) a board |
| Reopen a closed board |
| Get progress and burndown metrics for a board |
| Set the default board for a project |
| Remove the default board setting |
Tool | Description |
| List milestones in a project |
| Get milestone details (optionally embed boards) |
| Create a milestone with optional dates |
| Partially update a milestone (PATCH) |
| Full replacement of a milestone (PUT) |
| Permanently delete a milestone (optionally cascade to boards/work items) |
| Mark a milestone complete |
| Reopen a closed milestone |
| Get progress and burndown metrics for a milestone |
Tool | Description |
| List work items with filters (board, milestone, stage, category, user, completion, search, sort) |
| Get full work item details |
| Create a task with title, description, priority, assignee, estimate, due date, tags |
| Update any field on a work item (PATCH) |
| Create a copy of an existing work item |
| Delete a work item |
| List attachments on a work item |
| Get a specific work item attachment |
| Delete a work item attachment |
Tool | Description |
| List work item categories in a project |
| Get category details |
| Create a new category |
| Partially update a category (PATCH) |
| Delete a category |
Tool | Description |
| List workflow stages in a project |
| Get stage details |
| Create a new stage |
| Partially update a stage (PATCH) |
| Delete a stage |
Tool | Description |
| List importance levels in a project |
| Get importance level details |
| Create a new importance level |
| Partially update an importance level (PATCH) |
| Delete an importance level |
Tool | Description |
| Get your own user info |
| List users in a project |
| Get a specific user's project membership |
| Add a user to a project |
| Partially update a user's project membership (PATCH) |
| Full replacement of a user's project membership (PUT) |
| Add an entire team to a project |
| List roles in a project |
| Get a specific role |
| Create a new role |
| Partially update a role (PATCH) |
| Full replacement of a role (PUT) |
| Delete a role |
Tool | Description |
| List tags in a project |
| Create a new tag (with optional hex color) |
| Partially update a tag (PATCH) |
| Full replacement of a tag (PUT) |
| Delete a tag |
Tool | Description |
| List design elements (GDD documents) in a project |
| Get design element details |
| Create a new design element |
| Partially update a design element (PATCH) |
| Full replacement of a design element (PUT) |
| Delete a design element |
| Get metrics for a design element |
| List design element types in a project |
| Get a specific design element type |
| Create a new design element type |
| Partially update a design element type (PATCH) |
| Full replacement of a design element type (PUT) |
| Delete a design element type |
| List attachments on a design element |
| Get a specific design element attachment |
| Delete a design element attachment |
| List comments on a design element |
| Add a comment to a design element |
| Update a design element comment (PUT) |
| Delete a design element comment |
Tool | Description |
| List activity events for a project |
| List files stored in a project |
| Delete a file from a project |
| Get file storage quota and usage |
| List all available webhook event types |
| List webhooks configured for a project |
| Create a webhook for a project |
| Get webhook details |
| Partially update a webhook (PATCH) |
| Full replacement of a webhook (PUT) |
| Delete a webhook |
"Show me all work items in my Maze Racer project"
"Create a task called 'Implement leaderboard' in the Programming board, high priority"
"Close the current milestone and list what's still open"
"What tasks are assigned to me and not completed?"
"Create a GDD document for the combat system"
"Set up a webhook to notify my server when work items change"
The HacknPlan API is still in public beta — rate limit is 5 calls/second
API key needs appropriate scopes for the operations you want to perform
Categories, stages, and importance levels return 403 on write operations for most accounts (list/get still work)
create_work_item requires boardId; importanceLevelId defaults to 3 (Normal)
When creating a work item with a stageId, the handler issues a follow-up PATCH since the API ignores stageId on POST
Add a user to a project
Inputs: userId (required), projectId (required), roleId, isAdmin.
Add an entire team to a project
Inputs: teamId (required), projectId (required), roleId.
Transfer ownership of a project to another user
Inputs: userId (required), projectId (required).
Remove the default board setting for a project
Inputs: projectId (required).
Create a copy of an existing work item
Inputs: projectId (required), workItemId (required), boardId.
Archive (close) a board without deleting it. Use reopen_board to restore it.
Inputs: boardId (required), projectId (required).
Archive (close) a milestone without deleting it. Use reopen_milestone to restore it.
Inputs: projectId (required), milestoneId (required).
Archive (close) a project without deleting it. Use reopen_project to restore it.
Inputs: projectId (required).
Create a new board in a project
Inputs: name (required), projectId (required), milestoneId.
Create a new work item category in a project
Inputs: name (required), projectId (required), description.
Create a new design element (GDD document) in a project
Inputs: name (required), typeId (required), projectId (required), endDate, +2 more.
Add a comment to a design element
Inputs: text (required), projectId (required), designElementId (required).
Create a new design element type in a project
Inputs: name (required), projectId (required), description.
Create a new importance level in a project
Inputs: name (required), projectId (required), description.
Create a new milestone in a project
Inputs: name (required), projectId (required), endDate, startDate, +1 more.
Create a new project
Inputs: name (required), costMetric (required), description.
Create a new role in a project
Inputs: name (required), projectId (required), description.
Create a new tag in a project
Inputs: name (required), projectId (required), color.
Create a new workflow stage in a project
Inputs: name (required), projectId (required), description.
Create a new webhook for a project
Inputs: url (required), events (required), projectId (required), secret.
Create a new work item (task) in a project
Inputs: title (required), boardId (required), projectId (required), tags, +9 more.
Permanently delete a board
Inputs: boardId (required), projectId (required), removeWorkItems.
Permanently delete a category
Inputs: projectId (required), categoryId (required).
Delete a design element
Inputs: projectId (required), designElementId (required).
Delete an attachment from a design element
Inputs: projectId (required), attachmentId (required), designElementId (required).
Delete a comment from a design element
Inputs: commentId (required), projectId (required), designElementId (required).
Delete a design element type
Inputs: projectId (required), designElementTypeId (required).
Permanently delete an importance level
Inputs: projectId (required), importanceLevelId (required).
Permanently delete a milestone
Inputs: projectId (required), milestoneId (required), deleteBoards, deleteWorkItems.
Permanently delete a project
Inputs: projectId (required).
Delete a file from a project
Inputs: fileId (required), projectId (required).
Delete a project role
Inputs: roleId (required), projectId (required).
Delete a project tag
Inputs: tagId (required), projectId (required).
Permanently delete a stage
Inputs: stageId (required), projectId (required).
Delete a webhook
Inputs: projectId (required), webhookId (required).
Permanently delete a work item
Inputs: projectId (required), workItemId (required).
Delete an attachment from a work item
Inputs: projectId (required), workItemId (required), attachmentId (required).
Get details of a specific board
Inputs: boardId (required), projectId (required).
Get progress and burndown metrics for a board
Inputs: boardId (required), projectId (required).
Get details of a specific category
Inputs: projectId (required), categoryId (required).
Get information about the currently authenticated user
Inputs: no named parameters.
Get details of a specific design element
Inputs: projectId (required), designElementId (required).
Get a specific attachment on a design element
Inputs: projectId (required), attachmentId (required), designElementId (required).
Get metrics for a design element
Inputs: projectId (required), designElementId (required).
Get details of a specific design element type
Inputs: projectId (required), designElementTypeId (required).
Get details of a specific importance level
Inputs: projectId (required), importanceLevelId (required).
Get details of a specific milestone
Inputs: projectId (required), milestoneId (required), includeBoards.
Get progress and burndown metrics for a milestone
Inputs: projectId (required), milestoneId (required).
Get details of a specific project
Inputs: projectId (required).
Get progress and burndown metrics for a project
Inputs: projectId (required).
Get details of a specific project role
Inputs: roleId (required), projectId (required).
Get file storage quota and usage for a project
Inputs: projectId (required).
Get details of a specific user within a project
Inputs: userId (required), projectId (required).
Get details of a specific stage
Inputs: stageId (required), projectId (required).
Get details of a specific webhook
Inputs: projectId (required), webhookId (required).
Get details of a specific work item
Inputs: projectId (required), workItemId (required).
Get details of a specific work item attachment
Inputs: projectId (required), workItemId (required), attachmentId (required).
List all boards in a project
Inputs: projectId (required), includeClosed.
List work item categories in a project
Inputs: projectId (required).
List attachments on a design element
Inputs: projectId (required), designElementId (required).
List comments on a design element
Inputs: projectId (required), designElementId (required).
List design elements (GDD documents) in a project
Inputs: projectId (required), limit, offset, typeId.
List design element types in a project (used as typeId when creating design elements)
Inputs: projectId (required).
List importance levels in a project (used as importanceLevelId when creating work items)
Inputs: projectId (required).
List all milestones in a project
Inputs: projectId (required).
List activity events for a project
Inputs: projectId (required), limit, offset.
List files stored in a project
Inputs: projectId (required).
List all roles in a project
Inputs: projectId (required).
List all projects in your workspace
Inputs: limit, offset.
List all tags in a project
Inputs: projectId (required).
List users in a project
Inputs: projectId (required).
List workflow stages in a project
Inputs: projectId (required).
List all available webhook event types
Inputs: no named parameters.
List all webhooks configured for a project
Inputs: projectId (required).
List all attachments on a work item
Inputs: projectId (required), workItemId (required).
List work items in a project with optional filters and sorting
Inputs: projectId (required), limit, offset, boardId, +11 more.
Reopen a previously closed (archived) board
Inputs: boardId (required), projectId (required).
Reopen a previously closed (archived) milestone
Inputs: projectId (required), milestoneId (required).
Reopen a previously closed (archived) project
Inputs: projectId (required).
Full replacement of a board (PUT — all fields required)
Inputs: name (required), boardId (required), projectId (required), milestoneId.
Full replacement of a design element (PUT)
Inputs: name (required), typeId (required), projectId (required), designElementId (required), +3 more.
Full replacement of a design element type (PUT)
Inputs: name (required), projectId (required), designElementTypeId (required), description.
Full replacement of a milestone (PUT — all fields required)
Inputs: name (required), projectId (required), milestoneId (required), endDate, +2 more.
Full replacement of a project (PUT — all fields required)
Inputs: name (required), projectId (required), costMetric (required), description.
Full replacement of a project role (PUT)
Inputs: name (required), roleId (required), projectId (required), description.
Full replacement of a project tag (PUT)
Inputs: name (required), tagId (required), projectId (required), color.
Full replacement of a user's project membership (PUT)
Inputs: userId (required), projectId (required), roleId, isAdmin, +1 more.
Full replacement of a webhook (PUT)
Inputs: url (required), events (required), projectId (required), webhookId (required), +1 more.
Set the default board for a project
Inputs: boardId (required), projectId (required).
Partially update a board (PATCH — only provided fields are changed)
Inputs: boardId (required), projectId (required), name, milestoneId.
Partially update a category (PATCH — only provided fields are changed)
Inputs: projectId (required), categoryId (required), name, description.
Partially update a design element (PATCH)
Inputs: projectId (required), designElementId (required), name, typeId, +3 more.
Update a comment on a design element (PUT — replaces content)
Inputs: text (required), commentId (required), projectId (required), designElementId (required).
Partially update a design element type (PATCH)
Inputs: projectId (required), designElementTypeId (required), name, description.
Partially update an importance level (PATCH — only provided fields are changed)
Inputs: projectId (required), importanceLevelId (required), name, description.
Partially update a milestone (PATCH — only provided fields are changed)
Inputs: projectId (required), milestoneId (required), name, endDate, +2 more.
Partially update a project's name or description (PATCH — only provided fields are changed)
Inputs: projectId (required), name, description.
Partially update a project role (PATCH)
Inputs: roleId (required), projectId (required), name, description.
Partially update a project tag (PATCH)
Inputs: tagId (required), projectId (required), name, color.
Partially update a user's project membership (PATCH)
Inputs: userId (required), projectId (required), roleId, isAdmin, +1 more.
Partially update a stage (PATCH — only provided fields are changed)
Inputs: stageId (required), projectId (required), name, description.
Partially update a webhook (PATCH)
Inputs: projectId (required), webhookId (required), url, events, +1 more.
Update an existing work item
Inputs: projectId (required), workItemId (required), tags, title, +8 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 103 tools
Tools are clearly separated by resource type (board, milestone, design element, etc.) with distinct actions (create, get, update, replace, delete). However, the high number of tools and the presence of both update and replace for some resources could cause minor confusion, though descriptions clarify they are PATCH vs PUT.
All tool names follow a consistent verb_noun pattern using lowercase and underscores. Verbs like create, get, list, update, delete, replace, close, reopen are used uniformly across resource types, with no mixing of conventions.
With 103 tools, the set is very heavy. While each tool serves a specific purpose, many are redundant CRUD variants (e.g., separate replace_ and update_ for the same resource), and the overall count far exceeds typical MCP server scopes, making it unwieldy for agents.
The tool surface is remarkably comprehensive, covering all major entities (projects, boards, work items, milestones, design elements, roles, tags, stages, webhooks) with full CRUD, plus metrics, attachments, comments, and user management. Only minor gaps like bulk operations or advanced search are missing.
Simple kanban for small teams. Read and update your Moxboard boards and tasks from Claude.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.