Skip to content
MCP server

Pomodoro Ai MCP

Pomodoro focus timer and productivity stats as an MCP server for AI assistants

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally
Version
1.0.9
Listing updated
today

Similar MCP servers

About Pomodoro Ai MCP

Pomodoro Ai MCP is an open-source MCP server for time tracking. It runs locally on your machine and is started by your AI client.

The README says this MCP server lets an AI assistant manage Pomodoro focus sessions, breaks and basic productivity analytics. It installs from PyPI as a stdio server and is configured by adding a single entry to an MCP client config such as Claude Desktop.

The README's examples name three tools, start_session, stop_session and get_stats, which the assistant can call in conversation. No other tool names are listed, so the full set of capabilities is not documented in the repository.

The project is aimed at developers and users who already work with an MCP-compatible assistant and want time-boxed focus tracking inside that workflow. The repository is MIT-licensed and free to self-host. The README also promotes the vendor's paid compliance services, which are separate from this server.

Install

Run in a terminal

claude mcp add pomodoro-ai-mcp -- uvx pomodoro-ai-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pomodoro-ai-mcp": {
      "command": "uvx",
      "args": [
        "pomodoro-ai-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pomodoro-ai-mcp": {
      "command": "uvx",
      "args": [
        "pomodoro-ai-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pomodoro-ai-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pomodoro-ai-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pomodoro-ai-mcp": {
      "command": "uvx",
      "args": [
        "pomodoro-ai-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pomodoro-ai-mcp": {
      "command": "uvx",
      "args": [
        "pomodoro-ai-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

start_session
Starts a Pomodoro focus session.
stop_session
Stops the current focus session.
get_stats
Returns productivity statistics.

What it does

Focus session control
Starts and stops Pomodoro work sessions through named tool calls from an AI client.
Break management
Handles break periods alongside focus sessions as part of the Pomodoro cycle.
Productivity statistics
Exposes a get_stats tool for reviewing session-based productivity figures.
Stdio installation
Runs over stdio and installs with pip or uvx, with a ready-to-paste client config.

Good for

  • Start and stop focus sprints from within an AI chat without switching apps
  • Review how many focus sessions were completed over a period
  • Add time-boxed work intervals to an assistant-driven daily planning routine

Pricing

Open source

MIT-licensed, free to self-host

Pomodoro Ai MCP FAQ

How do I install it?

The README gives pip install pomodoro_ai_mcp, or npx via Smithery, and shows a claude_desktop_config.json entry that runs it with uvx.

Is it free?

The repository's source is MIT-licensed and free to self-host. The README does not describe a paid hosted plan for this server.

Which tools does it expose?

The README examples mention start_session, stop_session and get_stats. It does not list further tools.

Is Pomodoro Ai MCP free?

Yes. Pomodoro Ai MCP is open source, so you can use and self-host it for free.

How do I add Pomodoro Ai MCP to Claude Code?

Run this command in your terminal: claude mcp add pomodoro-ai-mcp -- uvx pomodoro-ai-mcp

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers