@bluesun-networks/huly-mcp
MCP server for Huly project management — issues, documents, people, and labels.
Wraps the official @hcengineering/api-client to expose Huly operations as Model Context Protocol tools.
Setup
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
HULY_URL |
No | http://localhost:8087 |
Huly instance URL |
HULY_EMAIL |
Yes | User email for authentication | |
HULY_PASSWORD |
Yes | User password | |
HULY_WORKSPACE |
Yes | Workspace slug |
MCP Client Configuration```json
{
"mcpServers": {
"huly": {
"command": "npx",
"args": ["@bluesun-networks/huly-mcp"],
"env": {
"HULY_URL": "https://huly.example.com",
"HULY_EMAIL": "user@example.com",
"HULY_PASSWORD": "password",
"HULY_WORKSPACE": "my-workspace"
}
}
}
}
## Tools
### Issues (Tracker)
| Tool | Description |
|---|---|
| `list_projects` | List all projects in the workspace |
| `list_issues` | List issues in a project (filter by priority) |
| `get_issue` | Get a single issue by identifier (e.g. `HULY-123`) |
| `create_issue` | Create an issue with title, description, priority, due date |
| `update_issue` | Update issue fields |
### Documents
| Tool | Description |
|---|---|
| `list_teamspaces` | List document teamspaces |
| `list_documents` | List documents in a teamspace |
| `create_document` | Create a document with markdown content |
### People / Contacts
| Tool | Description |
|---|---|
| `list_people` | List people with email addresses |
| `create_person` | Create a person with email |
### Labels
| Tool | Description |
|---|---|
| `list_labels` | List available labels for issues |
| `add_label` | Add a label to an issue |
## Build```bash
npm install
npm run build
node dist/index.js
License
MIT
