Rhizm Server

MCP (Model Context Protocol) server for Rhizm. Allows LLM clients (Claude Desktop, Claude Code, etc.) to operate tasks, timers, and notes via natural language.

Install

npm install -g @rhizmapp/mcp

Or run directly with npx:

npx @rhizmapp/mcp

Setup

1. Generate an API key at https://rhizm.app/ → Settings → API Keys
2. Configure your MCP client (see below)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "rhizm": {
      "command": "npx",
      "args": ["@rhizmapp/mcp"],
      "env": {
        "RHIZM_API_KEY": "rz_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Code

.claude/settings.json:

{
  "mcpServers": {
    "rhizm": {
      "command": "npx",
      "args": ["@rhizmapp/mcp"],
      "env": {
        "RHIZM_API_KEY": "rz_..."
      }
    }
  }
}

Environment Variables

Variable	Required	Default	Description
RHIZM_API_KEY	yes	—	Your API key (rz_...)
RHIZM_API_URL	no	https://api.rhizm.app	API base URL

Tools

Tool	Required permission	Description
list_tasks	read	List tasks (date range / tag filter)
create_task	write	Create a task
update_task	write	Update a task
delete_task	delete	Delete a task
start_timer	timer	Start timer for a task
stop_timer	timer	Stop timer for a task
get_running_timers	read	Get running timers
time_summary	read	Aggregated time summary
list_notes	read	List notes
get_note	read	Get a single note
create_note	write	Create a note

Documentation

For full API documentation, see docs/api.md.