How do I use hae-mcp?

1. Click on "Deploy 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., "@hae-mcp show me 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.

hae-mcp

by bzhzion

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

hae-mcp

MCP server for hae — a self-hosted GTD task management app. Gives Claude full access to your hae instance: projects, cards, columns, checklists, comments, labels, organisations, notifications, users, and AI features.

Version: 1.3.2 | 100% API coverage — 57 tools | hae-app · hae-api

Requirements

Node.js 18+
A running hae-api instance

Related MCP server: Planka MCP Server for Claude

Installation

Via npx (recommended — no install needed)

{
  "mcpServers": {
    "hae": {
      "command": "npx",
      "args": ["-y", "@breizhzion/hae-mcp"],
      "env": {
        "HAE_URL": "http://your-server:3000",
        "HAE_TOKEN": "your-jwt-token"
      }
    }
  }
}

Via local clone

git clone https://github.com/bzhzion/hae-mcp
cd hae-mcp
npm install
npm run build

{
  "mcpServers": {
    "hae": {
      "command": "node",
      "args": ["/path/to/hae-mcp/dist/index.js"],
      "env": {
        "HAE_URL": "http://localhost:3000",
        "HAE_EMAIL": "user@example.com",
        "HAE_PASSWORD": "yourpassword"
      }
    }
  }
}

Where to put the config

Client	Config file
Claude Code (global)	`~/.claude/settings.json`
Claude Desktop (Mac)	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Desktop (Windows)	`%APPDATA%\Claude\claude_desktop_config.json`

Authentication

HAE_TOKEN takes priority. If absent, auto-login with HAE_EMAIL + HAE_PASSWORD.

Variable	Description
`HAE_URL`	hae-api base URL. Default: `http://localhost:3000`
`HAE_TOKEN`	JWT token — recommended for production
`HAE_EMAIL`	Email for auto-login
`HAE_PASSWORD`	Password for auto-login

To get a token manually:

curl -X POST http://your-server:3000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","password":"yourpassword"}'
# → {"token":"eyJ..."}

Tools

Projects

Tool	Description
`hae_list_projects`	List all accessible projects with their columns
`hae_get_project`	Get a project by ID
`hae_create_project`	Create a new project
`hae_update_project`	Update project name or description
`hae_delete_project`	Delete a project permanently
`hae_assign_project_org`	Assign a project to an organisation
`hae_add_project_member`	Add a user to a project
`hae_update_project_member`	Change a project member's role
`hae_remove_project_member`	Remove a member from a project

`hae_create_project`

Parameter	Type	Required	Description
`name`	string	yes	Project name
`description`	string	no	Optional description

`hae_update_project`

Parameter	Type	Required	Description
`id`	string	yes	Project ID
`name`	string	no	New name
`description`	string	no	New description

`hae_assign_project_org`

Parameter	Type	Required	Description
`id`	string	yes	Project ID
`org_id`	string	yes	Organisation ID

`hae_add_project_member` / `hae_update_project_member`

Parameter	Type	Required	Description
`id`	string	yes	Project ID
`user_id`	string	yes	User ID (use `hae_search_users` to find it)
`role`	`owner` \| `member`	no/yes	Role

Columns

Tool	Description
`hae_create_column`	Create a custom column in a project
`hae_update_column`	Rename a column
`hae_delete_column`	Delete a column (cards moved to Trash)

`hae_create_column`

Parameter	Type	Required	Description
`project_id`	string	yes	Project ID
`name`	string	yes	Column name

Cards

Tool	Description
`hae_list_cards`	List cards in a column (with checklist progress + comment count)
`hae_get_card`	Get full card details
`hae_create_card`	Create a card in a column
`hae_update_card`	Update or move a card
`hae_duplicate_card`	Duplicate a card
`hae_delete_card`	Trash or permanently delete a card
`hae_get_card_activities`	Get the activity log of a card
`hae_stopwatch_start`	Start the stopwatch on a card
`hae_stopwatch_stop`	Stop the stopwatch on a card
`hae_add_card_member`	Assign a user to a card
`hae_remove_card_member`	Unassign a user from a card
`hae_add_card_label`	Add a label to a card
`hae_remove_card_label`	Remove a label from a card
`hae_subscribe_card`	Subscribe to notifications for a card
`hae_unsubscribe_card`	Unsubscribe from notifications for a card

`hae_create_card`

Parameter	Type	Required	Description
`column_id`	string	yes	Target column ID
`title`	string	yes	Card title
`description`	string	no	Description — Markdown supported
`due_date`	number	no	Due date as Unix timestamp in ms

`hae_update_card`

Parameter	Type	Required	Description
`id`	string	yes	Card ID
`title`	string	no	New title
`description`	string	no	New description (Markdown)
`due_date`	number or null	no	New due date (Unix ms), or `null` to clear
`column_id`	string	no	Target column ID — moves the card

`hae_delete_card`

Parameter	Type	Required	Description
`id`	string	yes	Card ID
`permanent`	boolean	no	`true` = hard delete. Default: `false` (moves to Trash)

Comments

Tool	Description
`hae_list_comments`	List all comments on a card
`hae_add_comment`	Add a comment to a card
`hae_update_comment`	Edit a comment
`hae_delete_comment`	Delete a comment

`hae_add_comment` / `hae_update_comment`

Parameter	Type	Required	Description
`card_id` / `id`	string	yes	Card ID or Comment ID
`content`	string	yes	Comment text

Checklists

Tool	Description
`hae_add_checklist`	Add a checklist to a card
`hae_update_checklist`	Rename a checklist
`hae_delete_checklist`	Delete a checklist and all its items
`hae_add_checklist_item`	Add an item to a checklist
`hae_toggle_checklist_item`	Mark an item done or undone
`hae_delete_checklist_item`	Delete a checklist item

`hae_add_checklist_item`

Parameter	Type	Required	Description
`checklist_id`	string	yes	Checklist ID
`content`	string	yes	Item text

`hae_toggle_checklist_item`

Parameter	Type	Required	Description
`item_id`	string	yes	Checklist item ID
`is_done`	boolean	yes	`true` = done, `false` = undone

Labels

Tool	Description
`hae_list_labels`	List all labels in a project
`hae_create_label`	Create a label
`hae_update_label`	Update a label name or color
`hae_delete_label`	Delete a label

`hae_create_label`

Parameter	Type	Required	Description
`project_id`	string	yes	Project ID
`name`	string	yes	Label name
`color`	string	yes	Hex color, e.g. `#FF5733`

Organisations

Tool	Description
`hae_list_orgs`	List all organisations the current user belongs to
`hae_get_org`	Get organisation details: members and projects
`hae_create_org`	Create an organisation
`hae_update_org`	Update organisation name or description
`hae_delete_org`	Delete an organisation
`hae_add_org_member`	Add a user to an organisation
`hae_update_org_member`	Change a member's role
`hae_remove_org_member`	Remove a member from the organisation

`hae_add_org_member` / `hae_update_org_member`

Parameter	Type	Required	Description
`id`	string	yes	Organisation ID
`user_id`	string	yes	User ID
`role`	`owner` \| `admin` \| `member`	no/yes	Role

Notifications

Tool	Description
`hae_list_notifications`	List notifications for the current user
`hae_mark_notification_read`	Mark a notification as read
`hae_mark_all_notifications_read`	Mark all notifications as read

Users

Tool	Description
`hae_get_me`	Get the current user's profile
`hae_update_me`	Update display name
`hae_change_password`	Change the current user's password
`hae_search_users`	Search a user by exact email — useful to find IDs

`hae_search_users`

Parameter	Type	Required	Description
`email`	string	yes	Exact email address to look up

Note: Avatar upload (POST /api/users/me/avatar) is multipart binary — available in the app only, not via MCP.

`hae_change_password`

Parameter	Type	Required	Description
`current_password`	string	yes	Current password
`new_password`	string	yes	New password (min 8 characters)

AI

Tool	Description
`hae_ai_parse_tasks`	Parse free-form text into structured cards using AI
`hae_ai_generate_checklist`	Generate a checklist for a card using AI
`hae_ai_summarize_card`	Summarize a card (description + comments + activities)

`hae_ai_parse_tasks`

Parameter	Type	Required	Description
`project_id`	string	yes	Project ID where cards will be created
`text`	string	yes	Free-form text to parse into tasks

Admin (requires admin role)

Tool	Description
`hae_admin_list_users`	List all users on the server
`hae_admin_update_user`	Change a user's role or enable/disable their account
`hae_admin_delete_user`	Permanently delete a user account

`hae_admin_update_user`

Parameter	Type	Required	Description
`id`	string	yes	User ID
`role`	`admin` \| `user`	no	New role
`is_active`	boolean	no	`true` = active, `false` = disabled

User preferences

Tool	Description
`hae_get_prefs`	Get the current user's preferences (key/value store)
`hae_set_prefs`	Set one or more preferences

`hae_set_prefs`

Parameter	Type	Required	Description
`prefs`	object	yes	Key/value pairs, e.g. `{ "theme": "dark", "lang": "fr" }`

Example prompts

List my projects and show me what's in the URGENT column.

Create a card "Fix login bug" in the NEXT column of project X with description:
"## Steps\n- Check JWT expiry\n- Test on mobile" and due date in 2 days.

Move card abc123 to the SOMEDAY column.

Add a "Definition of Done" checklist to card abc123 with 3 items:
unit tests passing, code reviewed, deployed to staging.

Search for user "alice" and add her to project X as member.

Generate a checklist for card abc123 using AI.

Mark all my notifications as read.

Parse this text into tasks in project X:
"Call client Monday, prepare slides for Thursday demo, review PR from Bob"

Development

git clone https://github.com/bzhzion/hae-mcp
cd hae-mcp
npm install
npm run dev    # tsx watch — hot reload
npm run build  # compile to dist/

Test with the official MCP inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Publishing

npm run build
npm publish --access public

License

MIT — Breizhzion

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessSyncing

Resources

Need Help?

Related Servers

Related MCP Connectors

mcpOAuth
net.todoist
Official Todoist MCP server for AI assistants to manage tasks, projects, and workflows.
App Automation Workplace & Productivity Project Management
2
LooperTaskOAuth
com.loopertask
AI-native Kanban board — connect Claude to claim, work and move your tasks over MCP.
Project Management Workplace & Productivity
1
mcp-serverOAuth
com.niftypm
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Project Management Communication File Systems
2
Kangram
app.kangram
Task & board management for AI agents + humans. Kanban, comments, digests via MCP.
Project Management
1

Related MCP Servers

Trello MCP Server
Project Management Workplace & Productivity
rdeprey
A
license
Not graded
quality
C
maintenance
An MCP server that connects Claude to Trello, enabling comprehensive management of boards, lists, and cards through natural language conversation. It supports a wide range of actions including searching cards, adding comments, managing checklists, and tracking board activity.
Updated 13 days ago (2026-09-03 00:55 UTC)
285 npm
ISC
Planka MCP Server for Claude
Project Management Workplace & Productivity
NextHeberg
A
license
Not graded
quality
D
maintenance
Enables AI-powered project management by connecting Claude to Planka kanban boards via 75+ MCP tools for creating, updating, and managing projects, boards, lists, and cards.
Updated 4 months ago (2026-05-23 13:11 UTC)
1
GPL 3.0
nirvana-mcp
Project Management Workplace & Productivity
Sgoettschkes
A
license
A
quality
D
maintenance
MCP server that exposes NirvanaHQ (GTD task manager) to Claude Code, enabling task management and project tracking through natural language.
Updated 3 months ago (2026-06-12 23:06 UTC)
15
9 npm
MIT
hacknplan-mcp
Project Management Workplace & Productivity
mtuska
A
license
B
quality
C
maintenance
Enables Claude to interact with HacknPlan project management via the MCP protocol. Provides tools for managing projects, work items, boards, milestones, time logs, design models, and cross-project portfolio views.
Updated 3 months ago (2026-06-18 01:25 UTC)
75
10 npm
MIT

hae-mcp

Requirements

Installation

Via npx (recommended — no install needed)

Via local clone

Where to put the config

Authentication

Tools

Projects

hae_create_project

hae_update_project

hae_assign_project_org

hae_add_project_member / hae_update_project_member

Columns

hae_create_column

Cards

hae_create_card

hae_update_card

hae_delete_card

Comments

hae_add_comment / hae_update_comment

Checklists

hae_add_checklist_item

hae_toggle_checklist_item

Labels

hae_create_label

Organisations

hae_add_org_member / hae_update_org_member

Notifications

Users

hae_search_users

hae_change_password

AI

hae_ai_parse_tasks

Admin (requires admin role)

hae_admin_update_user

User preferences

hae_set_prefs

Example prompts

Development

Publishing

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Trello MCP Server

Planka MCP Server for Claude

nirvana-mcp

hacknplan-mcp

`hae_create_project`

`hae_update_project`

`hae_assign_project_org`

`hae_add_project_member` / `hae_update_project_member`

`hae_create_column`

`hae_create_card`

`hae_update_card`

`hae_delete_card`

`hae_add_comment` / `hae_update_comment`

`hae_add_checklist_item`

`hae_toggle_checklist_item`

`hae_create_label`

`hae_add_org_member` / `hae_update_org_member`

`hae_search_users`

`hae_change_password`

`hae_ai_parse_tasks`

`hae_admin_update_user`

`hae_set_prefs`