Tempo MCP — Calendar and Time Tracking for Agents
MCP server that gives AI agents calendar awareness and time tracking. Tempo MCP integrates with Google Calendar and Toggl for scheduling, time logging, and availability checks.
What it is
Tempo MCP is a Model Context Protocol server that gives AI agents access to calendar and time tracking functionality. It integrates with Google Calendar for scheduling and availability, and with Toggl for time logging.
Tempo MCP targets developers building AI assistants that need to manage schedules, block focus time, check meeting availability, or log work hours -- all through natural language commands.
How it saves time or tokens
Instead of switching between calendar apps, time trackers, and chat interfaces, Tempo MCP lets you ask your AI agent questions like 'What meetings do I have today?' or 'Log 3 hours of coding.' The agent handles the API calls directly. Token estimate is approximately 3200 tokens per session.
How to use
- Add Tempo MCP to your MCP config:
{
"mcpServers": {
"tempo": {
"command": "npx",
"args": ["-y", "tempo-mcp-server"],
"env": {
"GOOGLE_CALENDAR_CREDENTIALS": "/path/to/credentials.json",
"TOGGL_API_TOKEN": "your-token"
}
}
}
}
- Restart your AI client (Claude Code, Cursor, etc.).
- Ask your agent about your schedule or log time entries.
Example
# Natural language commands your agent can handle:
'What meetings do I have today?'
'Block 2 hours for deep work tomorrow morning'
'Log 3 hours of coding on the TokRepo project'
'When am I free this week for a 1-hour meeting?'
'Cancel my 3pm meeting and notify attendees'
Related on TokRepo
- AI Tools for Automation -- Productivity and workflow automation tools
- AI Tools for Task Management -- Task and project management tools
Common pitfalls
- Google Calendar credentials require OAuth setup through the Google Cloud Console. The credentials.json file must have Calendar API access enabled.
- Toggl API tokens are personal and workspace-scoped. Ensure you use the correct token for the workspace where you want to log time.
- Calendar operations may fail silently if the agent lacks permission to modify events created by others.
Frequently Asked Questions
Tempo MCP currently integrates with Google Calendar. You need to set up Google Cloud OAuth credentials and provide them via the GOOGLE_CALENDAR_CREDENTIALS environment variable.
Yes. Tempo MCP integrates with Toggl Track for time logging. Provide your Toggl API token in the MCP config and the agent can create, update, and query time entries.
Yes. Add the Tempo MCP server to your .mcp.json configuration file. After restarting Claude Code, the agent can access calendar and time tracking tools.
Yes. The agent can create new calendar events, block focus time, and modify existing events. It requires write access in the Google Calendar OAuth scope.
Check the Tempo MCP GitHub repository for the current license. The server is distributed as an npm package that you run locally through the MCP protocol.
Citations (3)
- MCP Specification— Model Context Protocol specification for AI tool integration
- Google Calendar API— Google Calendar API for scheduling and event management
- Toggl API Documentation— Toggl Track API for time tracking
Related on TokRepo
Source & Thanks
Community MCP server for calendar and time management.
Available via
npx tempo-mcp-server