YouGile MCP: 66 tools with access tiers

yougile-mcp

A local stdio server on the YouGile REST API v2 for projects, boards, tasks, stickers, chats and webhooks, with writes and deletes behind separate flags

  • 0 ★ on the repository
  • Last commit
MCP server

Broad access

Why this level

  • Can change and soft-delete tasks, employees, roles and webhooks when the flags are on
  • The API key gives account-owner rights in the company
All reasons and checks
Russian stack

notequal21/yougile-mcp

Install

Services

Manual install

claude mcp add yougile \
  --env YOUGILE_API_KEY=<ключ> \
  --env YOUGILE_ALLOW_WRITES=true \
  -- node /абсолютный/путь/к/yougile-mcp/dist/index.js

The README command after `npm run build`.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Can change and soft-delete tasks, employees, roles and webhooks when the flags are on
  • The API key gives account-owner rights in the company

This is third-party code. Review the repository files before installing.

What it does

The Node.js server connects an agent to YouGile through the REST API v2 and registers 66 tools: 25 reading, 29 writing and 12 destructive. The agent reads and changes projects, boards, columns, tasks, stickers, chats, employees, departments, roles and webhooks. Permissions are tiered: without `YOUGILE_ALLOW_WRITES=true` the mutating tools are not registered at all, and soft delete and user or role removal appear only with `YOUGILE_ALLOW_DESTRUCTIVE=true`. The client keeps a request budget, 40 per minute by default, and pages through lists up to a set limit. The API address is configurable, so both the YouGile cloud and self-hosted installs fit. The server never accepts a password: the key is made by hand with two `curl` requests.

Who it is for. Project managers and automation developers on YouGile who want to give an agent read access first and enable edits and deletes later.

Good fit when

  • You need a board summary with columns, tasks and stickers and nothing in YouGile may change
  • Tasks have to be created from a thread and assignees set, so write mode is switched on
  • The company runs YouGile on its own server and the API address has to be set
  • Task chats and project webhooks need exporting to review integrations

Not a fit when

  • You need a ready package: it is not on npm and builds from a clone with `npm install` and `npm run build`
  • You need proven behaviour on real data: the author says no live check has been done yet
  • You want a one-off script without a standing server: calling the REST API directly is simpler

Example request

Show all tasks in the In progress column of the Product board and group them by assignee

MCP

Transport
stdio
Authentication
API key

Environment variables

YOUGILE_API_KEY required, secret
YouGile API bearer key
YOUGILE_BASE_URL
YouGile server address, default https://yougile.com
YOUGILE_ALLOW_WRITES
Enables mutating tools
YOUGILE_ALLOW_DESTRUCTIVE
Enables deletion, requires YOUGILE_ALLOW_WRITES
YOUGILE_RATE_LIMIT_PER_MIN
Request budget per minute, 1–50, default 40

Limitations

The README states directly that all 66 tools are implemented but no live check against a real YouGile has been done yet and the tests use no network. There is no npm package: the server runs from an absolute path to `dist/index.js` after a build on Node.js 20 or newer. The key is made by hand with `curl` requests using a login and password, an account is limited to about 30 keys and a key does not expire. No license is stated. There are no stars and one author.

How to disable. Remove the `yougile` entry from the client configuration or run `claude mcp remove yougile` and delete the key in YouGile settings.

FAQ

How do I get the API key?

With two `curl` requests to `auth/companies` and `auth/keys` using your login and password, and the reply holds the key for `YOUGILE_API_KEY`. The password is never given to the server or stored.

How do I enable writes?

Set `YOUGILE_ALLOW_WRITES=true`. Without it the mutating tools are not registered and the agent simply does not see them.

What does `YOUGILE_ALLOW_DESTRUCTIVE` do?

It enables soft delete plus user and role removal and works only together with `YOUGILE_ALLOW_WRITES=true`.

Does it work with a self-hosted YouGile?

Yes, `YOUGILE_BASE_URL` takes your server address over `https` only, with `http://localhost` allowed for testing.

Is there protection against API limits?

Yes, the client keeps a 40 requests per minute budget, changed with `YOUGILE_RATE_LIMIT_PER_MIN` in the range 1–50, and transient failures are retried.

Discussion

No questions or reviews yet.

Russian stack

A dependency-free YouGile MCP server: fifteen tools, with read-only and destructive actions marked via MCP annotations

MCP serverBroad access2Repository stars

YouGile MCP

Yougile MCP Server

Russian stack

MCP server for YouGile: projects, boards, columns, tasks, users and task chats from the agent

MCP serverBroad access19Repository stars

yougile-mcp

@nebelov/yougile-mcp

Russian stack

An MCP server for the YouGile task tracker covering API v2: projects, boards, tasks, chats, users, stickers and webhooks

MCP serverBroad access10Repository stars
Editors’ pick

Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit

MCP serverBroad access
Russian stack

A production-grade MCP server for YouGile: 44 full-CRUD tools, resources, ready prompts and two transports

MCP serverBroad access2Repository stars
Russian stack

A YouGile MCP server with access profiles, read-only by default, OpenAPI payload validation, audit logging, and secrets in Vault or protected files

MCP serverExtended access4Repository stars

README in short

The description begins with requirements and the build, then shows how to get a key, a table of environment variables, examples for Claude Desktop, Claude Code and Cursor and the safety tiers. The repository also holds QA reports in `docs/qa` and a dump of the YouGile OpenAPI v2 spec.

README badge

Report a problem