How do I use HacknPlan MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. 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.

HacknPlan MCP

by jompereira

Overview Schema Related Servers Score Discussions

JavaScript

Remote

HacknPlan MCP Server

Connect Claude directly to your HacknPlan game dev projects.

Setup

1. Get your API key

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

2. Install dependencies

npm install

3. Configure Claude Desktop

Add 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"
      }
    }
  }
}

4. Restart Claude Desktop

Related MCP server: hae-mcp

Available Tools

Projects

Tool	Description
`list_projects`	List all projects in your workspace
`get_project`	Get project details
`create_project`	Create a new project (`costMetric` required: `"points"` or `"hours"`)
`update_project`	Partially update a project's name or description (PATCH)
`replace_project`	Full replacement of a project (PUT)
`delete_project`	Permanently delete a project
`close_project`	Archive (close) a project
`reopen_project`	Reopen a closed project
`get_project_metrics`	Get progress and burndown metrics for a project
`change_project_owner`	Transfer project ownership to another user

Boards

Tool	Description
`list_boards`	List boards in a project (optionally include closed)
`get_board`	Get board details
`create_board`	Create a new board (optionally attach to a milestone)
`update_board`	Partially update a board (PATCH)
`replace_board`	Full replacement of a board (PUT)
`delete_board`	Permanently delete a board (optionally remove work items)
`close_board`	Archive (close) a board
`reopen_board`	Reopen a closed board
`get_board_metrics`	Get progress and burndown metrics for a board
`set_default_board`	Set the default board for a project
`clear_default_board`	Remove the default board setting

Milestones

Tool	Description
`list_milestones`	List milestones in a project
`get_milestone`	Get milestone details (optionally embed boards)
`create_milestone`	Create a milestone with optional dates
`update_milestone`	Partially update a milestone (PATCH)
`replace_milestone`	Full replacement of a milestone (PUT)
`delete_milestone`	Permanently delete a milestone (optionally cascade to boards/work items)
`close_milestone`	Mark a milestone complete
`reopen_milestone`	Reopen a closed milestone
`get_milestone_metrics`	Get progress and burndown metrics for a milestone

Work Items

Tool	Description
`list_work_items`	List work items with filters (board, milestone, stage, category, user, completion, search, sort)
`get_work_item`	Get full work item details
`create_work_item`	Create a task with title, description, priority, assignee, estimate, due date, tags
`update_work_item`	Update any field on a work item (PATCH)
`clone_work_item`	Create a copy of an existing work item
`delete_work_item`	Delete a work item
`list_work_item_attachments`	List attachments on a work item
`get_work_item_attachment`	Get a specific work item attachment
`delete_work_item_attachment`	Delete a work item attachment

Stages

Tool	Description
`list_stages`	List workflow stages in a project
`get_stage`	Get stage details
`create_stage`	Create a new stage
`update_stage`	Partially update a stage (PATCH)
`delete_stage`	Delete a stage

Importance Levels

Tool	Description
`list_importance_levels`	List importance levels in a project
`get_importance_level`	Get importance level details
`create_importance_level`	Create a new importance level
`update_importance_level`	Partially update an importance level (PATCH)
`delete_importance_level`	Delete an importance level

Users & Roles

Tool	Description
`get_current_user`	Get your own user info
`list_project_users`	List users in a project
`get_project_user`	Get a specific user's project membership
`add_project_user`	Add a user to a project
`update_project_user`	Partially update a user's project membership (PATCH)
`replace_project_user`	Full replacement of a user's project membership (PUT)
`add_team_to_project`	Add an entire team to a project
`list_project_roles`	List roles in a project
`get_project_role`	Get a specific role
`create_project_role`	Create a new role
`update_project_role`	Partially update a role (PATCH)
`replace_project_role`	Full replacement of a role (PUT)
`delete_project_role`	Delete a role

Design Elements (GDD)

Tool	Description
`list_design_elements`	List design elements (GDD documents) in a project
`get_design_element`	Get design element details
`create_design_element`	Create a new design element
`update_design_element`	Partially update a design element (PATCH)
`replace_design_element`	Full replacement of a design element (PUT)
`delete_design_element`	Delete a design element
`get_design_element_metrics`	Get metrics for a design element
`list_design_element_types`	List design element types in a project
`get_design_element_type`	Get a specific design element type
`create_design_element_type`	Create a new design element type
`update_design_element_type`	Partially update a design element type (PATCH)
`replace_design_element_type`	Full replacement of a design element type (PUT)
`delete_design_element_type`	Delete a design element type
`list_design_element_attachments`	List attachments on a design element
`get_design_element_attachment`	Get a specific design element attachment
`delete_design_element_attachment`	Delete a design element attachment
`list_design_element_comments`	List comments on a design element
`create_design_element_comment`	Add a comment to a design element
`update_design_element_comment`	Update a design element comment (PUT)
`delete_design_element_comment`	Delete a design element comment

Events, Files & Webhooks

Tool	Description
`list_project_events`	List activity events for a project
`list_project_files`	List files stored in a project
`delete_project_file`	Delete a file from a project
`get_project_storage`	Get file storage quota and usage
`list_webhook_event_types`	List all available webhook event types
`list_webhooks`	List webhooks configured for a project
`create_webhook`	Create a webhook for a project
`get_webhook`	Get webhook details
`update_webhook`	Partially update a webhook (PATCH)
`replace_webhook`	Full replacement of a webhook (PUT)
`delete_webhook`	Delete a webhook

Example prompts

"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"

Notes

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

Install Server

license - not found

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jompereira/HacknPlan-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Tool	Description
`list_categories`	List work item categories in a project
`get_category`	Get category details
`create_category`	Create a new category
`update_category`	Partially update a category (PATCH)
`delete_category`	Delete a category

Tool	Description
`list_project_tags`	List tags in a project
`create_project_tag`	Create a new tag (with optional hex color)
`update_project_tag`	Partially update a tag (PATCH)
`replace_project_tag`	Full replacement of a tag (PUT)
`delete_project_tag`	Delete a tag