Ithura MCP · ithura — Claude Code MCP server: what it does, how to install
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.
MIT updated 2026-08-09
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-mcpWhat mcp 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.
What it helps with
- 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 for the agent
- What's left in the current sprint?
- List everything that moved to Done over the past week
How to install mcp
Platform CLI
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-mcpReplace <…> with your own values
Platform CLI
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-mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How do I install Ithura MCP in Claude Code?
Run claude mcp add mcp -e ITHURA_API_KEY=<ITHURA_API_KEY> -e ITHURA_WORKSPACE_SLUG=<ITHURA_WORKSPACE_SLUG> -- npx -y ithura-mcp.
What does Ithura MCP do?
It lets the agent read and modify projects, tasks, sprints, modules and wiki pages in an Ithura workspace, returning structured JSON for each tool call.
What access does the server need?
An ITHURA_API_KEY token from Settings > API tokens and the workspace's ITHURA_WORKSPACE_SLUG; the token inherits the permissions of the account that created it, so the agent's reach is bound by that account's own access.
Similar MCP servers
All MCP servers for Notes, tasks and projects →mcp by other authors comes first.