undertow-mcp

MCP server for the Undertow app — passive time tracking and workspace tools for Claude Code.

Requires an Undertow account. Undertow is currently a closed beta — sign-in is limited to invited accounts. The MCP server is non-functional without a valid API token.

Setup

Run the interactive wizard on any new machine:

npx undertow-mcp@latest setup

It will:

1. Ask for your API token (get one at Settings > Integrations)
2. Scan for git repos and let you pick the right one
3. Map the repo to an Undertow project
4. Configure session hooks for time tracking
5. Install the Tandy managed agent

Then restart Claude Code and run /agent tandy.

Manual MCP Server Config

If you just want the MCP server without the wizard, add to ~/.claude.json:

{
  "mcpServers": {
    "undertow": {
      "command": "npx",
      "args": ["-y", "undertow-mcp"],
      "env": {
        "UNDERTOW_API_TOKEN": "ut_your_token_here"
      }
    }
  }
}

What it does

33 tools for managing your workspace from Claude Code:

• Tasks — query, create, update, delete, change status, comment, tag
• Projects — list, create, update, delete, get AI-generated briefs
• Time — log entries, query history, review and resolve proposals
• Tags & Clients — create and manage
• Notifications — list and mark read
• Figma files — attach, list, and remove Figma files on projects
• Setup — register git remotes for automatic project mapping
• Session — get current tracking status, reconcile signals at session end

Passive time tracking:

Every tool call is recorded as an interaction signal. When your session ends, Undertow's metabolism engine analyzes the signals to detect activity bursts and propose time entries — no manual logging required.

Environment variables

| Variable | Required | Default | |----------|----------|---------| | UNDERTOW_API_TOKEN | Yes | — | | UNDERTOW_API_URL | No | the Undertow API base URL |

License

MIT