English Français العربية

com.ithura/mcp

Official registry Productivity

Manage tasks, sprints, projects, and wiki pages in your Ithura workspace.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package ithura-mcp
Claude Code 
claude mcp add com-ithura-mcp -e 'ITHURA_API_KEY=<your ithura_api_key>' -e 'ITHURA_WORKSPACE_SLUG=<ITHURA_WORKSPACE_SLUG>' -e 'ITHURA_API_URL=https://api.ithura.com' -- npx -y ithura-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "com-ithura-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "ithura-mcp@1.0.1"
            ],
            "env": {
                "ITHURA_API_KEY": "<your ithura_api_key>",
                "ITHURA_WORKSPACE_SLUG": "<ITHURA_WORKSPACE_SLUG>",
                "ITHURA_API_URL": "https://api.ithura.com"
            }
        }
    }
}

Environment variables

  • ITHURA_API_KEY required secret Workspace API token, created under Settings > API tokens. Carries the permissions of the member who created it.
  • ITHURA_WORKSPACE_SLUG required The workspace slug, as it appears in your Ithura URL.
  • ITHURA_API_URL API base URL. Defaults to https://api.ithura.com; set this when self-hosting.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Ithura MCP server
  2. Install
  3. Configuration
  4. Tools
  5. Notes
  6. Links
  7. License

Ithura MCP server

A Model Context Protocol server for Ithura, a quiet project management workspace for deliberate teams.

Point Claude, Cursor, or any MCP client at your Ithura workspace and let it read and write real work: tasks, sprints, projects, modules, wiki pages, and intake.

"What is left in the current sprint?"
"Create a task for the login timeout bug and put it in this sprint."
"Summarise every task that moved to Done this week."

Listed in the official MCP Registry as com.ithura/mcp.

Install

No install step. Point your MCP client at npx:

npx ithura-mcp
Claude Desktop / Claude Code

Add to your MCP settings (claude_desktop_config.json, or .mcp.json in a project for Claude Code):

{
  "mcpServers": {
    "ithura": {
      "command": "npx",
      "args": ["-y", "ithura-mcp"],
      "env": {
        "ITHURA_API_KEY": "your-api-token",
        "ITHURA_WORKSPACE_SLUG": "your-workspace"
      }
    }
  }
}
Cursor

~/.cursor/mcp.json takes the same block.

Configuration

VariableRequiredDefaultNotes
ITHURA_API_KEYyesWorkspace API token, from Settings > API tokens
ITHURA_WORKSPACE_SLUGyesThe slug in your workspace URL
ITHURA_API_URLnohttps://api.ithura.comPoint at your own host when self-hosting

Create the token in Ithura under Settings > API tokens. It carries the permissions of the member who created it, so create it as a user whose access matches what you want the agent to have.

Tools

23 tools across the work graph:

AreaTools
Projectslist_projects, get_project, create_project, update_project
Taskslist_issues, get_issue, create_issue, update_issue, delete_issue
Commentslist_issue_comments, add_issue_comment
Sprintslist_cycles, create_cycle, add_issues_to_cycle, remove_issue_from_cycle
Moduleslist_modules, create_module, add_issues_to_module, delete_module
Metadatalist_states, list_labels, create_label
Searchsearch_workspace

Every tool returns JSON, so the model sees real field values rather than prose.

Notes

  • The API noun for a work item is issue in the HTTP API; the product calls them tasks. The tool names follow the API.
  • Writes are real. Consider a token scoped to a member with limited project access if you want the agent kept to a corner of the workspace.
  • Self-hosting: set ITHURA_API_URL to your instance and everything else works unchanged.

License

MIT

Frequently asked questions

What is com.ithura/mcp?

Manage tasks, sprints, projects, and wiki pages in your Ithura workspace.

How do I install com.ithura/mcp?

It runs on your machine. In Claude Code: claude mcp add com-ithura-mcp -e 'ITHURA_API_KEY=<your ithura_api_key>' -e 'ITHURA_WORKSPACE_SLUG=<ITHURA_WORKSPACE_SLUG>' -e 'ITHURA_API_URL=https://api.ithura.com' -- npx -y ithura-mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.ithura/mcp need an API key?

Yes. It expects ITHURA_API_KEY, ITHURA_WORKSPACE_SLUG, which you set in its configuration.

Is com.ithura/mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains com.ithura/mcp?

It is published by Ithura. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.