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
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
Install
- Works in
- Services
Manual install
claude mcp add yougile \
--env YOUGILE_API_KEY=<ключ> \
--env YOUGILE_ALLOW_WRITES=true \
-- node /абсолютный/путь/к/yougile-mcp/dist/index.jsThe README command after `npm run build`.
Access and checks
How we reviewBroad 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 assigneeMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
YOUGILE_API_KEYrequired, 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.
Related
All YouGile toolsyougile-api-mcp by trueblackat
yougile-api-mcp
A dependency-free YouGile MCP server: fifteen tools, with read-only and destructive actions marked via MCP annotations
YouGile MCP
Yougile MCP Server
MCP server for YouGile: projects, boards, columns, tasks, users and task chats from the agent
yougile-mcp
@nebelov/yougile-mcp
An MCP server for the YouGile task tracker covering API v2: projects, boards, tasks, chats, users, stickers and webhooks
YouGile MCP by Indalo
YouGile MCP
Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit
yougile-mcp by Ivan Tereshin
yougile-mcp
A production-grade MCP server for YouGile: 44 full-CRUD tools, resources, ready prompts and two transports
YouGile MCP with security policies
YouGile MCP
A YouGile MCP server with access profiles, read-only by default, OpenAPI payload validation, audit logging, and secrets in Vault or protected files
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.