@nebelov/yougile-mcp

MCP server for YouGile 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 на русском

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

Quick Start

Auto-setup (recommended)

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):

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": { "YOUGILE_API_KEY": "your-key" }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": { "YOUGILE_API_KEY": "your-key" }
    }
  }
}

Gemini CLI (~/.gemini/settings.json):

{
  "mcpServers": {
    "yougile": {
      "command": "npx",
      "args": ["-y", "@nebelov/yougile-mcp"],
      "env": { "YOUGILE_API_KEY": "your-key" }
    }
  }
}

VS Code (.vscode/mcp.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 (free).

Step 1. Start the server with HTTP transport:

YOUGILE_API_KEY=your-key npx @nebelov/yougile-mcp --http --port 3000