# Yougile Mcp

> MCP server for YouGile — 57 tools, full API v2 coverage. Works with Claude, ChatGPT, Gemini, VS Code, Cursor.

- **Type:** MCP server
- **Install:** `agentstack add mcp-nebelov-yougile-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nebelov](https://agentstack.voostack.com/s/nebelov)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nebelov](https://github.com/nebelov)
- **Source:** https://github.com/nebelov/yougile-mcp

## Install

```sh
agentstack add mcp-nebelov-yougile-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# @nebelov/yougile-mcp

[](https://www.npmjs.com/package/@nebelov/yougile-mcp)
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
[](https://nodejs.org/)

MCP server for [YouGile](https://yougile.com) project management. **57 tools** covering 100% of YouGile API v2.

Works with **Claude**, **ChatGPT**, **Gemini CLI**, **VS Code**, **Cursor**, and any MCP-compatible client.

[README on Russian / README на русском](docs/README.ru.md)

  
  
  AI agent creates project, boards, columns, and tasks with rich descriptions — all via MCP

## Quick Start

### Auto-setup (recommended)

```bash
npx @nebelov/yougile-mcp --setup
```

Logs you into YouGile, gets an API key, and writes the config for your AI tool.

### Manual setup

1. Get an API key from YouGile (Settings > API or `POST /auth/keys`)
2. Add to your AI tool config:

**Claude Code** (`~/.claude.json`):
```json
{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": { "YOUGILE_API_KEY": "your-key" }
    }
  }
}
```

**Claude Desktop** (`claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": { "YOUGILE_API_KEY": "your-key" }
    }
  }
}
```

**Gemini CLI** (`~/.gemini/settings.json`):
```json
{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": { "YOUGILE_API_KEY": "your-key" }
    }
  }
}
```

**VS Code** (`.vscode/mcp.json`):
```json
{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": { "YOUGILE_API_KEY": "your-key" }
    }
  }
}
```

## ChatGPT Setup

### Option A: Hosted (recommended)

Use the hosted server at `you-mcp.com` — no installation needed.

**In ChatGPT (web):**
1. Settings > Apps & Connectors > Advanced > **Developer Mode** ON
2. Click **Create** > paste `https://you-mcp.com/mcp` > Save
3. Open any chat > click **+** > More > Developer Mode > enable your connector
4. ChatGPT will redirect you to login with your YouGile email and password
5. Your credentials go directly to YouGile's API (zero-knowledge proxy — the server never sees your password)

### Option B: Self-hosted (ngrok)

> Requires [ngrok](https://ngrok.com/) (free).

**Step 1.** Start the server with HTTP transport:
```bash
YOUGILE_API_KEY=your-key npx @nebelov/yougile-mcp --http --port 3000
```

**Step 2.** In a second terminal, create an HTTPS tunnel:
```bash
ngrok http 3000
```
Copy the `https://...ngrok-free.app` URL from ngrok output.

**Step 3.** In ChatGPT (web):
1. Settings > Apps & Connectors > Advanced > **Developer Mode** ON
2. Click **Create** > paste `https://YOUR-URL.ngrok-free.app/mcp` > Save
3. Open any chat > click **+** > More > Developer Mode > enable your connector

## Available Tools (57)

| Module | Tools | Description |
|--------|-------|-------------|
| projects | 4 | list, get, create, update |
| boards | 4 | list, get, create, update |
| columns | 4 | list, get, create, update |
| tasks | 6 | list, get, create, update, get/set chat-subscribers |
| chat | 8 | messages (list, send, get, delete) + group chats (list, get, create, update) |
| users | 5 | list, get, invite, update, delete |
| company | 2 | get, update |
| departments | 4 | list, get, create, update |
| project-roles | 5 | list, get, create, update, delete |
| string-stickers | 6 | CRUD + create/update state |
| sprint-stickers | 6 | CRUD + create/update state |
| webhooks | 3 | list, create, update |

## Bundled Skill

The package includes `skill/SKILL.md` — a best-practices guide for working with YouGile through AI. Copy it to your project or Claude Code skills directory for better task management.

## API Patterns

- **Soft delete**: `PUT {deleted: true}` works for all entities. `DELETE` method only works for project roles.
- **Pagination**: `{paging: {count, limit, offset, next}, content: [...]}`. Exception: `/webhooks` returns raw array.
- **Sticker fields**: Use `name` (not `title`) for stickers and states.
- **Task assigned**: Array of UUIDs `["uuid1", "uuid2"]`, not an object.
- **Chat messages**: `PUT` only supports `{deleted: true}` — editing text is not possible.
- **State IDs**: 12-char hex strings (not UUID).

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `YOUGILE_API_KEY` | Yes | YouGile API key |
| `YOUGILE_API_HOST_URL` | No | Custom API URL (default: `https://yougile.com/api-v2`) |

## Development

```bash
git clone https://github.com/nebelov/yougile-mcp
cd yougile-mcp
npm install
npm run dev
```

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nebelov](https://github.com/nebelov)
- **Source:** [nebelov/yougile-mcp](https://github.com/nebelov/yougile-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-nebelov-yougile-mcp
- Seller: https://agentstack.voostack.com/s/nebelov
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.