Skip to main content
Glama

YouGile Secure MCP

A local stdio Model Context Protocol server for the YouGile API v2. Read-only by default; writes require an explicit, single-use approval issued after the user confirms the exact payload in chat.

Tools (v0.2.0)

Read-only

Tool

Purpose

get_current_user

Profile that owns the API key

list_projects, get_project

Projects

list_boards, get_board

Boards

list_columns

Columns

list_tasks

Compact task summaries with server-side filters (column, assignee, title, sticker)

get_task

Full task object by UUID

find_task_by_short_id

Look up a task by human-readable ID such as ID-484 / DEV-484

list_task_comments

Task chat messages

list_users

Company users (filter by project or email)

list_string_stickers

Custom stickers and their states

All list tools return {"items": [...], "has_more": bool}; limit is capped at 100, use offset for the next page.

Staged writes (explicit approval required)

Tool

Purpose

propose_task_create

Stage a new task, returns a preview + single-use approval token

propose_task_update

Stage changes to an existing task, same contract

apply_approved_action

Execute a staged action; the only tool that can mutate YouGile

The flow is: agent stages an action → shows the preview to the user → the user approves in chat → agent calls apply_approved_action with the token. Tokens are bound to the exact payload, single-use, and expire after YOUGILE_APPROVAL_TTL_SECONDS (default 600). Delete operations are not implemented at all.

Security model

  • Uses only YOUGILE_API_KEY; never accepts, stores, or sends an account login/password.

  • Never creates, lists, or deletes YouGile API keys, webhooks, or users.

  • Never writes credentials to disk; API errors never include response bodies, so the key cannot leak through error messages.

  • All object IDs interpolated into URL paths are validated as UUIDs (no path traversal).

  • YOUGILE_BASE_URL must be https (plain http is allowed only for localhost).

  • Handles the YouGile rate limit (50 requests/minute) with bounded retries on HTTP 429.

Related MCP server: yougile-mcp

Install

git clone https://github.com/ropuwz-dot/MCP-Yougile.git
cd MCP-Yougile
python3 -m venv .venv
.venv/bin/python -m pip install -e '.[dev]'   # Linux/macOS
# .venv\Scripts\python -m pip install -e .[dev]  # Windows

Run it with the API key in the environment:

export YOUGILE_API_KEY='your-api-key'         # Windows: $env:YOUGILE_API_KEY='your-api-key'
.venv/bin/python run_server.py                # Windows: .venv\Scripts\python run_server.py

Configuration

Variable

Default

Purpose

YOUGILE_API_KEY

— (required)

YouGile API v2 key

YOUGILE_BASE_URL

https://yougile.com

Self-hosted deployments: the mainPageUrl from your conf.json

YOUGILE_TIMEOUT_SECONDS

30

HTTP timeout

YOUGILE_APPROVAL_TTL_SECONDS

600

Lifetime of a staged write approval

YOUGILE_SSL_CA_CERT

—

Path to a CA bundle for self-hosted servers with a self-signed certificate

YOUGILE_ALLOW_INSECURE_HTTP

false

Explicit opt-in for plain-http local self-hosted servers

Self-hosted (box) YouGile

The self-hosted Linux Server edition exposes the same API v2 on your own domain. Point YOUGILE_BASE_URL at the mainPageUrl value from your conf.json:

  • HTTPS with a self-signed certificate — set YOUGILE_SSL_CA_CERT to the path of the certificate (or its CA) so TLS verification keeps working. Verification can never be turned off.

  • Plain HTTP on a trusted local network — allowed by YouGile for local use, but here it requires YOUGILE_ALLOW_INSECURE_HTTP=true so the API key is never sent in clear text by accident. http://localhost works without the flag.

Client configuration

Claude Code

claude mcp add yougile -e YOUGILE_API_KEY=your-api-key -- /absolute/path/to/MCP-Yougile/.venv/bin/python /absolute/path/to/MCP-Yougile/run_server.py

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "yougile": {
      "command": "/absolute/path/to/MCP-Yougile/.venv/bin/python",
      "args": ["/absolute/path/to/MCP-Yougile/run_server.py"],
      "env": { "YOUGILE_API_KEY": "your-api-key" }
    }
  }
}

Hermes

Keep the secret in ~/.hermes/.env with 0600 permissions:

YOUGILE_API_KEY=your-api-key

Then add this server under mcp_servers in ~/.hermes/config.yaml:

mcp_servers:
  yougile:
    command: /absolute/path/to/MCP-Yougile/.venv/bin/python
    args: [/absolute/path/to/MCP-Yougile/run_server.py]
    env:
      YOUGILE_API_KEY: "${YOUGILE_API_KEY}"
    timeout: 60
    connect_timeout: 30
    sampling:
      enabled: false

Verify it before restarting Hermes: hermes mcp test yougile.

Development

.venv/bin/python -m pytest -q
.venv/bin/python -m ruff check src tests
.venv/bin/python -m mypy

CI runs the same three checks on Python 3.11–3.13 for every push and pull request.

License

MIT

Available Tools

15 tools
apply_approved_actionA

Execute a previously staged write action after the user explicitly approved it in chat. Requires the single-use approval token returned by a propose_* tool.

Inputs: approval_token (required). Returns: object

find_task_by_short_idA
Read-onlyIdempotent

Find a task by its human-readable ID such as ID-484 (company-wide) or DEV-484 (project). Scans the task list, so it may be slow on large workspaces; prefer get_task when the UUID is known.

Inputs: short_id (required). Returns: object

get_boardB
Read-onlyIdempotent

Get one board by its YouGile UUID.

Inputs: board_id (required). Returns: object

get_current_userA
Read-onlyIdempotent

Get the user profile that owns the configured YouGile API key.

Inputs: no named parameters. Returns: object

get_projectA
Read-onlyIdempotent

Get one project by its YouGile UUID.

Inputs: project_id (required). Returns: object

get_taskA
Read-onlyIdempotent

Get one task with all fields by its YouGile UUID.

Inputs: task_id (required). Returns: object

list_boardsA
Read-onlyIdempotent

List boards, optionally narrowed to a project. Returns items plus has_more; limit is capped at 100.

Inputs: limit, offset, project_id. Returns: object

list_columnsA
Read-onlyIdempotent

List columns, optionally narrowed to a board. Returns items plus has_more; limit is capped at 100.

Inputs: limit, offset, board_id. Returns: object

list_projectsA
Read-onlyIdempotent

List projects visible to the configured YouGile API key. Returns items plus has_more; limit is capped at 100, use offset to fetch the next page.

Inputs: limit, offset. Returns: object

list_string_stickersA
Read-onlyIdempotent

List custom stickers with their states, optionally narrowed to a board. Needed to decode task sticker values. Returns items plus has_more; limit is capped at 100.

Inputs: limit, offset, board_id. Returns: object

list_task_commentsA
Read-onlyIdempotent

List chat messages (comments) of a task, oldest first. Returns items plus has_more; limit is capped at 100.

Inputs: task_id (required), limit, since, offset, +1 more. Returns: object

list_tasksA
Read-onlyIdempotent

List tasks with server-side filters. Returns compact task summaries plus has_more (use get_task for the full object); limit is capped at 100. assigned_to accepts comma-separated user UUIDs.

Inputs: limit, title, offset, column_id, +3 more. Returns: object

list_usersA
Read-onlyIdempotent

List company users, optionally filtered by project or email. Returns items plus has_more; limit is capped at 100.

Inputs: email, limit, offset, project_id. Returns: object

propose_task_createA
Read-onlyIdempotent

Stage the creation of a task and get an approval token. Does NOT create anything: show the preview to the user, and only after the user explicitly approves call apply_approved_action with the token.

Inputs: title (required), column_id (required), assigned, description, +1 more. Returns: object

propose_task_updateA
Read-onlyIdempotent

Stage an update of an existing task and get an approval token. Does NOT change anything: show the preview to the user, and only after the user explicitly approves call apply_approved_action with the token. Allowed change fields: archived, assigned, checklists, color, columnId, completed, deadline, description, stickers, subtasks, timeTracking, title. Deleting tasks is not supported.

Inputs: changes (required), task_id (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action. Read tools (get_*, list_*) are separate from write tools (propose_*, apply_approved_action). The find_task_by_short_id is unique. No overlapping purposes.

    Naming Consistency5/5

    All tool names use lower_snake_case and follow a verb_noun pattern. Verbs are consistently get_, list_, find_, propose_, apply_. No mixing of conventions.

    Tool Count5/5

    15 tools is appropriate for a project management server. It covers listing and getting all major entities, plus a safe write pattern, without being excessive or too sparse.

    Completeness4/5

    Covers reading all entities and creating/updating tasks with a safe approval pattern. Missing delete for tasks and modifications for boards/columns/projects, but these are reasonable omissions given the secure nature.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for YouGile project management. Provides 57 tools covering 100% of YouGile API v2, enabling natural language management of projects, boards, columns, tasks, chats, users, and more.
      57
      74 npm
      10
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An unofficial, security-focused MCP server for YouGile REST API, providing policy-controlled tools with read-only defaults and optional direct-write profiles.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables read-only MCP access to Yandex Tracker for retrieving issues with comments and attachment metadata, searching issues, reading issue history, downloading attachments, and finding users. It also supports connection status checks and token configuration without exposing secrets.
      46 npm
      MIT