Pomodoro Ai MCP
Pomodoro focus timer and productivity stats as an MCP server for AI assistants
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"pomodoro-ai-mcp": {
"command": "uvx",
"args": [
"pomodoro-ai-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"pomodoro-ai-mcp": {
"command": "uvx",
"args": [
"pomodoro-ai-mcp"
]
}
}
}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.