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

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": "[email protected]",
        "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":"[email protected]","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