# time-management

Connect an assistant to Pyunto Time Management to inspect schedules, summarize logged hours, and manage time blocks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: pyunto
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pyunto/tm-integrations/tree/HEAD/mcp
- Updated: 2026-10-18
- HTML: https://affpapa.org/en/nevibecode/mcp/time-management

## What it does

The server exposes tools for browsing projects, tasks, and time blocks, plus summaries grouped by project, task, or date. An assistant can add or edit entries with `log_time` and `update_time_block`. Deletion targets one block at a time, and the model is instructed to show that block and get the user's approval first.

Set `PYUNTO_TM_API_KEY` to access account data. To decrypt E2EE names and notes, provide the Pyunto TM password through `PYUNTO_TM_PASSWORD` or `PYUNTO_TM_PASSWORD_FILE`; the password is handled locally. Schedule data and aggregates remain available without it, but name fields are empty. MCP clients launch the server with `npx -y @pyunto/tm-mcp`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PYUNTO_TM_API_KEY`, `PYUNTO_TM_BASE_URL`, `PYUNTO_TM_PASSWORD`, `PYUNTO_TM_PASSWORD_FILE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env PYUNTO_TM_API_KEY=<PYUNTO_TM_API_KEY> --env PYUNTO_TM_BASE_URL=<PYUNTO_TM_BASE_URL> --env PYUNTO_TM_PASSWORD=<PYUNTO_TM_PASSWORD> --env PYUNTO_TM_PASSWORD_FILE=<PYUNTO_TM_PASSWORD_FILE> --transport stdio mcp -- npx -y @pyunto/tm-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env PYUNTO_TM_API_KEY=<PYUNTO_TM_API_KEY> --env PYUNTO_TM_BASE_URL=<PYUNTO_TM_BASE_URL> --env PYUNTO_TM_PASSWORD=<PYUNTO_TM_PASSWORD> --env PYUNTO_TM_PASSWORD_FILE=<PYUNTO_TM_PASSWORD_FILE> -- npx -y @pyunto/tm-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@pyunto/tm-mcp"
            ],
            "env": {
                "PYUNTO_TM_API_KEY": "<PYUNTO_TM_API_KEY>",
                "PYUNTO_TM_BASE_URL": "<PYUNTO_TM_BASE_URL>",
                "PYUNTO_TM_PASSWORD": "<PYUNTO_TM_PASSWORD>",
                "PYUNTO_TM_PASSWORD_FILE": "<PYUNTO_TM_PASSWORD_FILE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@pyunto/tm-mcp"
            ],
            "env": {
                "PYUNTO_TM_API_KEY": "<PYUNTO_TM_API_KEY>",
                "PYUNTO_TM_BASE_URL": "<PYUNTO_TM_BASE_URL>",
                "PYUNTO_TM_PASSWORD": "<PYUNTO_TM_PASSWORD>",
                "PYUNTO_TM_PASSWORD_FILE": "<PYUNTO_TM_PASSWORD_FILE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PYUNTO_TM_API_KEY=<PYUNTO_TM_API_KEY> -e PYUNTO_TM_BASE_URL=<PYUNTO_TM_BASE_URL> -e PYUNTO_TM_PASSWORD=<PYUNTO_TM_PASSWORD> -e PYUNTO_TM_PASSWORD_FILE=<PYUNTO_TM_PASSWORD_FILE> mcp npx -y @pyunto/tm-mcp
```
Replace <…> with your own values

## When to use it
- inspect projects and tasks in a Pyunto schedule
- summarize logged hours by project or date
- add a time entry to a block
- edit or remove a single time block

## Example prompts
- Show my Pyunto Time Management projects and tasks.
- Summarize logged hours by project for the selected period.
- Add a time entry, then show me the block before removing it.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md