SkillFoxx

yougile-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

  • 2 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Can delete tasks, projects, boards and columns via tools flagged destructiveHint
  • The API key is permanent and grants company-wide access; the README explicitly warns about the risk if it leaks
All reasons and checks
Russian stack

trueblackat/yougile-api-mcpAuthor:trueblackat

Install

Services

Manual install

npx github:trueblackat/yougile-api-mcp

Runs straight from GitHub with no install.

Access and checks

How we review

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

  • Can delete tasks, projects, boards and columns via tools flagged destructiveHint
  • The API key is permanent and grants company-wide access; the README explicitly warns about the risk if it leaks

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

What it does

The whole server is one Node.js file using the built-in fetch, with zero npm dependencies. Fifteen tools start with yougile_map, which gives a board map with the IDs the other calls need, followed by stickers, tasks (list, get, create, update with move/complete/delete via deleted:true), comments, employees and structure (creating and editing projects, boards, columns). Every tool carries MCP annotations, readOnlyHint or destructiveHint, so the client knows what's safe to call without confirmation and what can erase data. Inviting or removing employees, roles, departments, company settings, API keys and webhooks are deliberately left out.

Who it is for. For anyone who wants a minimal-code but honestly risk-annotated YouGile MCP server with no third-party dependencies.

Good fit when

  • It matters that the server physically cannot manage company employees, roles and API keys
  • You want a server with zero npm dependencies that's easy to read end to end
  • You need clear labeling of which calls are safe and which can erase data

Not a fit when

  • You need employee invites, roles, departments, webhooks or API-key management: none of that exists here
  • You want a full 40+ tool set rather than fifteen focused ones

Example request

Show the map of the "Sales" board and move task SALE-12 into the "Closed" column

MCP

Transport
stdio
Authentication
API key

Environment variables

YOUGILE_API_KEY required, secret
A permanent YouGile API key, inheriting the rights of the employee who issued it.
YOUGILE_BASE_URL
API address, defaults to https://yougile.com/api-v2.

Limitations

Needs Node.js 18+ (uses the built-in fetch). The API key grants company-wide access; the README explicitly warns against sharing it in group chats or committing it to git. The key can only be obtained via the --login mode (email and password); YouGile's own interface has no button to issue one.

How to disable. Remove the yougile entry from your MCP client config, and if the key may have leaked, issue a new one via --login and delete the old one through the API.

FAQ

Can I invite an employee through this server?

No, inviting or removing employees, roles and company settings are deliberately not implemented: the key already grants company-wide access, and the README recommends doing that in YouGile's own interface instead.

How do I get an API key if YouGile's UI has no button for it?

Via node yougile-mcp.mjs --login, which asks for an email and password once and issues a key through the API.

How is yougile-api-mcp by trueblackat different from other YouGile servers?

The whole server fits in one Node.js file with built-in fetch and no npm dependencies. Fifteen tools start with yougile_map, which gives a board map with identifiers for other calls. Tools are marked read-only and destructive by MCP annotations.

Can I invite an employee through the server and how do I get an API key?

Inviting employees is not listed among the tools, check the tools section of the README. A YouGile API key is created through the API authorization request. Run npx github:trueblackat/yougile-api-mcp. It works in Claude Code, Claude Desktop and Cursor.

Discussion

No questions or reviews yet.

All YouGile tools
Russian stack

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

MCP serverBroad access2

yougile-mcp-server by Ra53n

yougile-mcp-server

Russian stack

YouGile MCP without any hard delete tool: strongest mutation is reversible archiving

MCP serverExtended access
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 Go MCP server for YouGile with 24 tools where mutating operations require confirmation and are written to an audit log

MCP serverExtended access
Russian stack

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

MCP serverBroad access
Russian stack

An 18-tool YouGile MCP server that can fetch keys for every company on an account and switch the active one on the fly

MCP serverExtended access

README in short

The bilingual README lists all fifteen tools with their safety annotations, separately explains the --login mode for issuing a key and the --check mode for verifying it, gives a large section on YouGile API quirks (HTML instead of markdown, millisecond deadlines, a 50-requests-per-minute limit, a deprecated GET /tasks), and ends with instructions for Claude Code and other JSON-config clients.

README badge

Report a problem