yougile-mcp-server

Smart MCP server for YouGile project management. Provides 19 composable tools and 4 planning prompts for AI-powered task management.

Features

• Smart workspace navigation — get full project/board/column hierarchy in one call
• Task CRUD + batch operations — create, search, update, bulk-modify tasks
• Sticker management — labels and sprint stickers with full state control
• Collaboration — users, chat messages, notifications
• AI planning prompts — day/week planning, sprint reviews, board status reports
• Rate limiting — built-in token bucket respecting YouGile's 50 req/min limit

Quick Start

1. Get a YouGile API Key

curl -X POST https://yougile.com/api-v2/auth/keys \
  -H "Content-Type: application/json" \
  -d '{"login": "[email protected]", "password": "your-password", "companyId": "your-company-id"}'

To find your company ID first:

curl -X POST https://yougile.com/api-v2/auth/companies \
  -H "Content-Type: application/json" \
  -d '{"login": "[email protected]", "password": "your-password"}'

2. Configure in Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["yougile-mcp-server"],
      "env": {
        "YOUGILE_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Configure in Claude Code

claude mcp add yougile -- npx yougile-mcp-server
# Then set the env var:
export YOUGILE_API_KEY="your-api-key-here"

Tools (19)

Structure & Navigation

| Tool | Description | |------|-------------| | get_board_structure | Full hierarchy: projects → boards → columns with task counts | | get_column_tasks | List tasks in a column | | search_tasks | Flexible search by column, assignee, sticker, title |

Task Operations

| Tool | Description | |------|-------------| | get_task | Get task details by ID or code (e.g. "SAI-515") | | create_task | Create task with all fields | | update_task | Update, move, complete, archive, or delete a task | | batch_update_tasks | Bulk update multiple tasks at once |

Stickers / Labels

| Tool | Description | |------|-------------| | list_stickers | All string + sprint stickers for a board | | manage_sticker | CRUD for sticker definitions and states | | set_task_stickers | Assign/remove stickers on a task |

Collaboration

| Tool | Description | |------|-------------| | list_users | List company users | | manage_user | Invite, update, or deactivate users | | get_task_chat | Read task chat messages | | send_message | Send message to a chat | | manage_chat_subscribers | Manage chat notification subscribers |

Administration

| Tool | Description | |------|-------------| | manage_project | CRUD for projects | | manage_board | CRUD for boards | | manage_column | CRUD for columns | | manage_webhooks | Manage event webhooks |

Prompts (4)

| Prompt | Description | |--------|-------------| | plan_my_day | AI-guided daily planning based on assigned tasks and deadlines | | plan_my_week | Weekly planning with workload balancing across days | | sprint_review | Sprint progress analysis with completion metrics | | board_status | Board health dashboard with actionable insights |

Development

npm install
npm run build
npm run dev  # watch mode with tsx

License

MIT