Overview

Pomodoro Ai MCP provides AI-powered tools via the Model Context Protocol (MCP).

Tools

Tool	Description
start_session	Start a new Pomodoro focus session. Optionally specify a task name and custom du
stop_session	Stop the current Pomodoro session. Mark as completed or interrupted. Add optiona
get_stats	Get Pomodoro productivity statistics for the last N days (default 7).
configure_timer	Configure Pomodoro timer durations. Customise work, short break, long break, and
get_productivity_report	Generate a detailed productivity report with insights and recommendations.

Installation

pip install meok-pomodoro-ai-mcp

Usage with Claude Desktop

Add to your Claude Desktop MCP config (claude_desktop_config.json):

{
  "mcpServers": {
    "pomodoro-ai": {
      "command": "python",
      "args": ["-m", "meok_pomodoro_ai_mcp.server"]
    }
  }
}

Usage with FastMCP

from mcp.server.fastmcp import FastMCP

# This server exposes 5 tool(s) via MCP
# See server.py for full implementation

License

MIT © MEOK AI Labs