Back to Directory/Documentation

com.ithura/mcp

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

DocumentationTypeScriptv1.0.1

Ithura MCP server

npm MCP Registry license

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.

Links

License

MIT

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y ithura-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "com-ithura-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ithura-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

ithura-mcpnpm

Compatible MCP Clients

com.ithura/mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More