# 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.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```json
{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["-y", "tempo-mcp-server"],
      "env": {
        "GOOGLE_CALENDAR_CREDENTIALS": "/path/to/credentials.json",
        "TOGGL_API_TOKEN": "your-token"
      }
    }
  }
}
```

Now ask your AI agent:
```
"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?"
```

## What is Tempo MCP?

Tempo MCP is a Model Context Protocol server that gives AI agents calendar and time tracking capabilities. It integrates with Google Calendar for scheduling and availability, and Toggl Track for time logging. Your AI agent can check your schedule, create events, find free slots, and log time — all through natural language.

**Answer-Ready**: Tempo MCP gives AI agents calendar and time tracking access. Integrates Google Calendar (events, availability, scheduling) and Toggl Track (time logging, reports). Natural language scheduling and time management for Claude Code and Cursor.

**Best for**: Developers wanting AI-managed scheduling and time tracking. **Works with**: Claude Code, Claude Desktop, Cursor, any MCP client. **Setup time**: Under 5 minutes.

## Core Tools

### Calendar Tools

| Tool | What It Does |
|------|-------------|
| list_events | Get events for a date range |
| create_event | Schedule a new event |
| find_free_slots | Find available time windows |
| update_event | Modify existing events |
| delete_event | Cancel an event |

### Time Tracking Tools

| Tool | What It Does |
|------|-------------|
| start_timer | Begin tracking time |
| stop_timer | Stop current timer |
| log_time | Log time entry retroactively |
| get_report | Time summary by project/date |

## Use Cases

| Use Case | Example |
|----------|---------|
| Daily standup prep | "What did I work on yesterday?" |
| Meeting scheduling | "Find a 30min slot with Alice this week" |
| Time logging | "Log 2 hours on the auth refactor" |
| Deep work blocking | "Block 3 hours every morning for coding" |
| Weekly reporting | "How many hours did I code this week?" |

## Configuration

### Google Calendar Setup

1. Create a Google Cloud project
2. Enable Calendar API
3. Download OAuth credentials JSON
4. Set `GOOGLE_CALENDAR_CREDENTIALS` env var

### Toggl Setup

1. Get API token from Toggl profile settings
2. Set `TOGGL_API_TOKEN` env var

## FAQ

**Q: Does it support multiple calendars?**
A: Yes, specify calendar ID to access any calendar your account can see.

**Q: Can I use it without Toggl?**
A: Yes, calendar-only mode works without Toggl configuration.

**Q: Is my calendar data sent to the LLM?**
A: Event details are passed to the LLM for reasoning. Use local models via Ollama for full privacy.

## Source & Thanks

> Community MCP server for calendar and time management.
>
> Available via `npx tempo-mcp-server`

<!-- ZH -->

## Quick Use

```json
{"mcpServers": {"tempo": {"command": "npx", "args": ["-y", "tempo-mcp-server"]}}}
```

Let AI agents manage your calendar and time tracking.

## What is Tempo MCP?

An MCP server that integrates Google Calendar and Toggl so AI agents can manage schedules and time tracking through natural language.

**TL;DR**: Calendar + time-tracking MCP server. Integrates Google Calendar and Toggl. Natural-language scheduling and time management.

**Best for**: Developers who want AI to manage their schedule and time.

## Core Tools

Calendar: view events, create events, find free time
Time: start timer, log time, generate reports

## FAQ

**Q: Can I skip Toggl?**
A: Yes — calendar-only mode works without Toggl.

## Source & Thanks

> Community MCP server, `npx tempo-mcp-server`

---
Source: https://tokrepo.com/en/workflows/tempo-mcp-calendar-time-tracking-agents-b84b96fd
Author: MCP Hub