Huly MCP Selfhost

Local install

io.github.JoKeks2023/huly-mcp-selfhostv3.5.1 GitHub verified

MCP server for Huly (self-hosted + cloud): 227 tools for AI agents, few tokens, Claude Code plugin

Productivity

Watch Source

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-11T22:40:18.073359Z",
      "publishedAt": "2026-11-11T22:40:18.073359Z",
      "statusChangedAt": "2026-11-11T22:40:18.073359Z"
    }
  },
  "server": {
    "name": "io.github.JoKeks2023/huly-mcp-selfhost",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "3.5.1",
    "packages": [
      {
        "version": "3.5.1",
        "transport": {
          "type": "stdio"
        },
        "identifier": "huly-mcp-selfhost",
        "registryType": "npm",
        "environmentVariables": [
          {
            "name": "HULY_EMAIL",
            "format": "string",
            "description": "Huly account email (option A, together with HULY_PASSWORD)"
          },
          {
            "name": "HULY_PASSWORD",
            "format": "string",
            "isSecret": true,
            "description": "Huly account password (option A)"
          },
          {
            "name": "HULY_TOKEN",
            "format": "string",
            "isSecret": true,
            "description": "Huly token for SSO accounts without a password (option B, get it via `npx huly-mcp-setup`)"
          },
          {
            "name": "HULY_ACCOUNTS_URL",
            "format": "string",
            "description": "Account service URL for self-hosted Huly. Default: https://account.huly.app"
          },
          {
            "name": "HULY_FRONT_URL",
            "format": "string",
            "description": "Front URL of your Huly instance, enables document/description content and uploads"
          },
          {
            "name": "HULY_TRANSACTOR_URL",
            "format": "string",
            "description": "Optional, self-hosted: internal transactor address (e.g. ws://huly/_transactor) instead of the public one"
          },
          {
            "name": "HULY_WORKSPACE",
            "format": "string",
            "description": "Optional: pin the server to one workspace (slug, name or id); tools then need no workspace argument"
          },
          {
            "name": "HULY_ANNOTATIONS",
            "format": "string",
            "description": "Optional: 1 = tool annotations (title, readOnlyHint, destructiveHint); ~16% larger tool list"
          },
          {
            "name": "HULY_DYNAMIC_TOOLSETS",
            "format": "string",
            "description": "Optional: 1 = start with HULY_TOOLSETS and load more toolsets on demand via enable_toolsets"
          },
          {
            "name": "HULY_TOOLSETS",
            "format": "string",
            "description": "Optional: comma-separated toolsets (agent, tracker, tracker-admin, documents, chat, contacts, inbox, activity, planner, calendar, github, generic, generic-write, collaboration, cards, fields, drive, templates, testing, products, members, recruiting, crm, hr, inventory, meetings, qms, process, surveys) or 'all'"
          },
          {
            "name": "HULY_WRITE_PROJECTS",
            "format": "string",
            "description": "Optional: only allow changes in these projects, e.g. TSK,WEB"
          },
          {
            "name": "HULY_CONFIRM",
            "format": "string",
            "description": "Optional: auto (default), strict or off — ask before deletes and other risky tools"
          },
          {
            "name": "HULY_AUDIT_LOG",
            "format": "string",
            "description": "Optional: file to append every change to (JSON lines)"
          },
          {
            "name": "HULY_FILE_ROOT",
            "format": "string",
            "description": "Optional: directory for local file upload/download (off when unset)"
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/JoKeks2023/huly-mcp",
      "source": "github"
    },
    "description": "MCP server for Huly (self-hosted + cloud): 227 tools for AI agents, few tokens, Claude Code plugin"
  }
}

Maintain this server? Claim it

Try it

This server only runs locally, from a package. Install it with the instructions on this page to try it.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Run in a terminal

claude mcp add huly-mcp-selfhost \
  -- npx -y [email protected]

Environment

HULY_EMAIL (optional, not in the config above): Huly account email (option A, together with HULY_PASSWORD)
HULY_PASSWORD (optional, not in the config above): Huly account password (option A)
HULY_TOKEN (optional, not in the config above): Huly token for SSO accounts without a password (option B, get it via `npx huly-mcp-setup`)
HULY_ACCOUNTS_URL (optional, not in the config above): Account service URL for self-hosted Huly. Default: https://account.huly.app
HULY_FRONT_URL (optional, not in the config above): Front URL of your Huly instance, enables document/description content and uploads
HULY_TRANSACTOR_URL (optional, not in the config above): Optional, self-hosted: internal transactor address (e.g. ws://huly/_transactor) instead of the public one
HULY_WORKSPACE (optional, not in the config above): Optional: pin the server to one workspace (slug, name or id); tools then need no workspace argument
HULY_ANNOTATIONS (optional, not in the config above): Optional: 1 = tool annotations (title, readOnlyHint, destructiveHint); ~16% larger tool list
HULY_DYNAMIC_TOOLSETS (optional, not in the config above): Optional: 1 = start with HULY_TOOLSETS and load more toolsets on demand via enable_toolsets
HULY_TOOLSETS (optional, not in the config above): Optional: comma-separated toolsets (agent, tracker, tracker-admin, documents, chat, contacts, inbox, activity, planner, calendar, github, generic, generic-write, collaboration, cards, fields, drive, templates, testing, products, members, recruiting, crm, hr, inventory, meetings, qms, process, surveys) or 'all'
HULY_WRITE_PROJECTS (optional, not in the config above): Optional: only allow changes in these projects, e.g. TSK,WEB
HULY_CONFIRM (optional, not in the config above): Optional: auto (default), strict or off — ask before deletes and other risky tools
HULY_AUDIT_LOG (optional, not in the config above): Optional: file to append every change to (JSON lines)
HULY_FILE_ROOT (optional, not in the config above): Optional: directory for local file upload/download (off when unset)

Tools

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Run in a terminal

claude mcp add huly-mcp-selfhost \
  -- npx -y [email protected]

Environment

HULY_EMAIL (optional, not in the config above): Huly account email (option A, together with HULY_PASSWORD)
HULY_PASSWORD (optional, not in the config above): Huly account password (option A)
HULY_TOKEN (optional, not in the config above): Huly token for SSO accounts without a password (option B, get it via `npx huly-mcp-setup`)
HULY_ACCOUNTS_URL (optional, not in the config above): Account service URL for self-hosted Huly. Default: https://account.huly.app
HULY_FRONT_URL (optional, not in the config above): Front URL of your Huly instance, enables document/description content and uploads
HULY_TRANSACTOR_URL (optional, not in the config above): Optional, self-hosted: internal transactor address (e.g. ws://huly/_transactor) instead of the public one
HULY_WORKSPACE (optional, not in the config above): Optional: pin the server to one workspace (slug, name or id); tools then need no workspace argument
HULY_ANNOTATIONS (optional, not in the config above): Optional: 1 = tool annotations (title, readOnlyHint, destructiveHint); ~16% larger tool list
HULY_DYNAMIC_TOOLSETS (optional, not in the config above): Optional: 1 = start with HULY_TOOLSETS and load more toolsets on demand via enable_toolsets
HULY_TOOLSETS (optional, not in the config above): Optional: comma-separated toolsets (agent, tracker, tracker-admin, documents, chat, contacts, inbox, activity, planner, calendar, github, generic, generic-write, collaboration, cards, fields, drive, templates, testing, products, members, recruiting, crm, hr, inventory, meetings, qms, process, surveys) or 'all'
HULY_WRITE_PROJECTS (optional, not in the config above): Optional: only allow changes in these projects, e.g. TSK,WEB
HULY_CONFIRM (optional, not in the config above): Optional: auto (default), strict or off — ask before deletes and other risky tools
HULY_AUDIT_LOG (optional, not in the config above): Optional: file to append every change to (JSON lines)
HULY_FILE_ROOT (optional, not in the config above): Optional: directory for local file upload/download (off when unset)