Pomodoro AI MCP
OfficialThis server lets you manage Pomodoro focus sessions, track productivity, and configure timer settings through an AI assistant:
Start a focus session (
start_session): Begin a new Pomodoro work session with an optional task name and custom duration (default: 25 min).Stop a session (
stop_session): End the current session, marking it as completed or interrupted, with optional notes.Get productivity stats (
get_stats): Retrieve productivity statistics for the last N days (default: 7 days).Configure the timer (
configure_timer): Customize work period, short break, long break, and sessions before a long break (defaults: 25 min work, 5 min short break, 15 min long break, 4 sessions before long break).Generate a productivity report (
get_productivity_report): Produce a detailed report with insights and recommendations based on your session history.
Pomodoro Ai MCP
Manage Pomodoro focus sessions, breaks, and productivity analytics
Manage Pomodoro focus sessions, breaks, and productivity analytics. By MEOK AI Labs.
š Quick Start
# Install via pip
pip install pomodoro_ai_mcp
# Or install via Smithery
npx -y @smithery/cli@latest install pomodoro-ai-mcp --client claudeRelated MCP server: Consciousness Engine MCP
⨠Features
MCP protocol compliant
Easy installation
Well-documented API
Production-ready
Active maintenance
š Documentation
š”ļø Compliance
This MCP server is built with EU AI Act compliance built-in:
ā Article 9 ā Risk Management System
ā Article 13 ā Transparency & Instructions for Use
ā Article 15 ā Bias Detection & Testing
ā Article 26 ā FRIA Support (where applicable)
ā Article 50 ā AI Content Watermarking (where applicable)
Need help getting compliant? Book a free 15-min diagnostic ā
š¢ Enterprise
Need custom development, SLA guarantees, or white-label deployment?
Pro: $99/mo ā Full MCP suite + EU AI Act tracking
Enterprise: $499/mo ā Custom dev + SLA + Dedicated support
View Pricing ā | Contact Sales ā
š¤ Part of the MEOK Ecosystem
This server is part of the MEOK AI Labs ecosystem ā 300+ MCP servers for sovereign AI governance.
Domain | Purpose |
EU AI Act compliance marketplace | |
AI safety & monitoring | |
Sovereign AI platform | |
Legacy modernization |
š License
MIT Ā© CSOAI-ORG
Pairs with MEOK Governance Suite
Build something that touches users? You need compliance. MEOK ships 38 governance MCPs that drop in alongside this tool ā EU AI Act, DORA, NIS2, CRA, GDPR, ISO 42001, FDA SaMD, MDR, Basel, MiFID II, MiCA, COPPA, and more.
# One-shot install of the governance pack
npx meok-setup --pack governanceFree tier: 10 calls/day per MCP. Pro tier (Ā£79/mo): unlimited + cryptographically signed compliance attestations your auditor verifies independently.
ā Full catalogue: councilof.ai/catalogue ā MEOK AI Labs: meok.ai
šø Try MEOK in 30 seconds ā instant buy ladder
Tier | Price | What you get | Stripe |
Smoke test | £1 | Signed sample MCP-Hardening report + Article 50 PDF | |
Quick Kit | £9 | EU AI Act Article 50 implementation guide (C2PA + EU-Icon) | |
Founder Call | £29 | 30-min 1-on-1 with the founder |
Refundable. UK Stripe ā VAT-clean. Builds on the 81-MCP MEOK fleet. Verify any signed report at https://meok.ai/verify.
Configuration
Add to your claude_desktop_config.json (Claude Desktop) or your MCP client config:
{
"mcpServers": {
"pomodoro-ai-mcp": {
"command": "uvx",
"args": ["pomodoro-ai-mcp"]
}
}
}Or: pip install pomodoro-ai-mcp then run the pomodoro-ai-mcp command (stdio transport).
Examples
Once configured, ask your assistant, for example:
"Use
start_sessionto ā¦""Use
stop_sessionto ā¦""Use
get_statsto ā¦"
Available Tools
5 toolsconfigure_timerD
Configure Pomodoro timer durations. Customise work, short break, long break, and session count before long break.
Behavior: This tool is read-only and stateless ā it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results.
Args: work_minutes (int): The work minutes to analyze or process. short_break (int): The short break to analyze or process. long_break (int): The long break to analyze or process. sessions_before_long (int): The sessions before long to analyze or process. api_key (str): The api key to analyze or process.
Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent ā calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.
Inputs: work_minutes, short_break, long_break, sessions_before_long, +1 more. Returns: result
get_productivity_reportA
Generate a detailed productivity report with insights and recommendations.
Behavior: This tool generates structured output without modifying external systems. Output is deterministic for identical inputs. No side effects. Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results.
Args: api_key (str): The api key to analyze or process.
Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent ā calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.
Inputs: api_key. Returns: result
get_statsA
Get Pomodoro productivity statistics for the last N days (default 7).
Behavior: This tool generates structured output without modifying external systems. Output is deterministic for identical inputs. No side effects. Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results.
Args: days (int): The days to analyze or process. api_key (str): The api key to analyze or process.
Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent ā calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.
Inputs: days, api_key. Returns: result
start_sessionD
Start a new Pomodoro focus session. Optionally specify a task name and custom duration (default uses configured timer).
Behavior: This tool is read-only and stateless ā it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results.
Args: task (str): The task to analyze or process. duration_minutes (int): The duration minutes to analyze or process. api_key (str): The api key to analyze or process.
Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent ā calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.
Inputs: task, duration_minutes, api_key. Returns: result
stop_sessionD
Stop the current Pomodoro session. Mark as completed or interrupted. Add optional notes.
Behavior: This tool is read-only and stateless ā it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage.
When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards.
When NOT to use: Not suitable for real-time production decision-making without human review of results.
Args: completed (bool): The completed to analyze or process. notes (str): The notes to analyze or process. api_key (str): The api key to analyze or process.
Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent ā calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.
Inputs: completed, notes, api_key. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: configure_timer sets durations, start_session and stop_session manage sessions, get_stats retrieves statistics, and get_productivity_report generates a report. No overlap in functionality.
All tool names follow the verb_noun pattern in snake_case (configure_timer, get_productivity_report, get_stats, start_session, stop_session), providing a predictable and consistent naming convention.
With 5 tools covering configuration, session management, and reporting, the count is well-scoped for a Pomodoro timer server. Each tool serves a clear and necessary function without bloat.
The tool surface covers the core lifecycle (configure, start, stop, view statistics/report). Minor gaps exist, such as no pause/resume or session listing, but these do not critically hinder basic workflow.
Maintenance
Related MCP Connectors
AI tool directory MCP server, live since July 2026. Tools, agents, models, companies, services.
Official MCP server for Agentwork ā delegate tasks to AI agents with human-in-the-loop
MCP server for Flux AI image generation
Related MCP Servers
- AlicenseAqualityCmaintenanceCron AI - MCP server providing AI-powered tools and automation by MEOK AI Labs411 npm41 PyPIMIT
- AlicenseNot gradedqualityFmaintenanceConsciousness Engine - MCP server providing AI-powered tools and automation by MEOK AI Labs5 npm37 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceCreativity Engine - MCP server providing AI-powered tools and automation by MEOK AI Labs6 npm38 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceNote Taking AI - MCP server providing AI-powered tools and automation by MEOK AI Labs8 npmMIT