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

## 快速使用

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

让 AI Agent 管理日历和时间追踪。

## 什么是 Tempo MCP？

MCP 服务器，集成 Google Calendar 和 Toggl，AI Agent 通过自然语言管理日程和时间。

**一句话总结**：日历 + 时间追踪 MCP 服务器，集成 Google Calendar 和 Toggl，自然语言调度和时间管理。

**适合人群**：希望 AI 管理日程和时间的开发者。

## 核心工具

日历：查看事件、创建事件、查找空闲时间
时间：开始计时、记录时间、生成报告

## 常见问题

**Q: 不用 Toggl 行吗？**
A: 可以，仅日历模式无需 Toggl。

## 来源与致谢

> 社区 MCP 服务器，`npx tempo-mcp-server`

---
Source: https://tokrepo.com/en/workflows/b84b96fd-0fc2-439d-9f29-4fb564bc2ded
Author: MCP Hub