# mcp

mcp connects an Ithura workspace to the agent so it can read and write tasks, sprints, projects and wiki pages. Answers questions about sprint status and files new tasks straight from chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: Ithura
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Ithura/ithura-mcp
- Updated: 2026-08-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ithura-mcp

## What it does

The server exposes 23 tools covering projects, tasks (called `issue` in the API, tasks in the product), comments, sprints (`cycles`), modules, statuses, labels and workspace search. Every tool returns JSON, so the model works with actual field values instead of parsed prose.

It runs through `npx ithura-mcp` with no separate install step. It needs an `ITHURA_API_KEY` token from Settings > API tokens and an `ITHURA_WORKSPACE_SLUG` matching the workspace URL; self-hosted instances set `ITHURA_API_URL` to their own host.

Writes go through to the real workspace: a task the agent creates or a sprint it edits shows up immediately. The token carries the permissions of whoever generated it, so scoping the agent to one project means issuing the token under a member whose own access is already limited that way.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ITHURA_API_KEY`, `ITHURA_WORKSPACE_SLUG`, `ITHURA_API_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ITHURA_API_KEY=<ITHURA_API_KEY> --env ITHURA_WORKSPACE_SLUG=<ITHURA_WORKSPACE_SLUG> --env ITHURA_API_URL=<ITHURA_API_URL> --transport stdio ithura-mcp -- npx -y ithura-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add ithura-mcp --env ITHURA_API_KEY=<ITHURA_API_KEY> --env ITHURA_WORKSPACE_SLUG=<ITHURA_WORKSPACE_SLUG> --env ITHURA_API_URL=<ITHURA_API_URL> -- npx -y ithura-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ithura-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "ithura-mcp"
            ],
            "env": {
                "ITHURA_API_KEY": "<ITHURA_API_KEY>",
                "ITHURA_WORKSPACE_SLUG": "<ITHURA_WORKSPACE_SLUG>",
                "ITHURA_API_URL": "<ITHURA_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ithura-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "ithura-mcp"
            ],
            "env": {
                "ITHURA_API_KEY": "<ITHURA_API_KEY>",
                "ITHURA_WORKSPACE_SLUG": "<ITHURA_WORKSPACE_SLUG>",
                "ITHURA_API_URL": "<ITHURA_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ITHURA_API_KEY=<ITHURA_API_KEY> -e ITHURA_WORKSPACE_SLUG=<ITHURA_WORKSPACE_SLUG> -e ITHURA_API_URL=<ITHURA_API_URL> ithura-mcp npx -y ithura-mcp
```
Replace <…> with your own values

## When to use it
- file a task from a bug description and drop it into the active sprint
- check what's left open in the current sprint
- pull together everything that moved to Done over a given stretch
- spin up a project or module without opening the web app
- search the workspace for a task or wiki page by keyword

## Example prompts
- What's left in the current sprint?
- List everything that moved to Done over the past week

## Similar
- [claudia](https://affpapa.org/en/nevibecode/mcp/claudia.md) — MCP server · ★ 15 repo stars
- [plan-harder](https://affpapa.org/en/nevibecode/skills/plan-harder.md) — skill · 1200 installs
- [planner](https://affpapa.org/en/nevibecode/skills/planner.md) — skill · 1200 installs
- [jira-cli](https://affpapa.org/en/nevibecode/skills/jira-cli.md) — skill · 646 installs
- [Linear](https://affpapa.org/en/nevibecode/mcp/docker-linear.md) — MCP server
- [clickup](https://affpapa.org/en/nevibecode/skills/krodak-clickup.md) — skill · ★ 132 repo stars

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12142 repo stars
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3033 repo stars
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2812 repo stars
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1379 repo stars
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 696 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
