What is this?

The Take Time MCP Server lets AI assistants manage your study blocks, activities, and schedule through the Model Context Protocol.

Talk to your AI naturally:

• "What do I have scheduled for today?"
• "Create a JavaScript block tomorrow at 9am"
• "Mark my morning study block as done"
• "How was my study week?"
• "Add a new micro-habit to my morning routine"
• "What's in my priority circle?"
• "Move 'Saúde' to zone 1"
• "Check off today's meditation in my morning block"

Quick Setup

1. Configure your AI client

No installation needed — just add the config to your AI client:

Edit ~/.claude/settings.json:

{
  "mcpServers": {
    "taketime": {
      "command": "npx",
      "args": ["-y", "@taketimemcp/mcp-server"],
      "env": {
        "TAKETIME_EMAIL": "[email protected]",
        "TAKETIME_PASSWORD": "your-password"
      }
    }
  }
}

Edit claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "taketime": {
      "command": "npx",
      "args": ["-y", "@taketimemcp/mcp-server"],
      "env": {
        "TAKETIME_EMAIL": "[email protected]",
        "TAKETIME_PASSWORD": "your-password"
      }
    }
  }
}

Edit .cursor/mcp.json in your project:

{
  "mcpServers": {
    "taketime": {
      "command": "npx",
      "args": ["-y", "@taketimemcp/mcp-server"],
      "env": {
        "TAKETIME_EMAIL": "[email protected]",
        "TAKETIME_PASSWORD": "your-password"
      }
    }
  }
}

Edit .vscode/mcp.json:

{
  "servers": {
    "taketime": {
      "command": "npx",
      "args": ["-y", "@taketimemcp/mcp-server"],
      "env": {
        "TAKETIME_EMAIL": "[email protected]",
        "TAKETIME_PASSWORD": "your-password"
      }
    }
  }
}

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "taketime": {
      "command": "npx",
      "args": ["-y", "@taketimemcp/mcp-server"],
      "env": {
        "TAKETIME_EMAIL": "[email protected]",
        "TAKETIME_PASSWORD": "your-password"
      }
    }
  }
}

Edit ~/.gemini/antigravity/mcp.json:

{
  "mcpServers": {
    "taketime": {
      "command": "npx",
      "args": ["-y", "@taketimemcp/mcp-server"],
      "env": {
        "TAKETIME_EMAIL": "[email protected]",
        "TAKETIME_PASSWORD": "your-password"
      }
    }
  }
}

Edit ~/.opencode/config.json:

{
  "mcpServers": {
    "taketime": {
      "command": "npx",
      "args": ["-y", "@taketimemcp/mcp-server"],
      "env": {
        "TAKETIME_EMAIL": "[email protected]",
        "TAKETIME_PASSWORD": "your-password"
      }
    }
  }
}

2. Restart your AI client

The Take Time tools should now appear. Try: "List my study subjects"

Authentication

Three methods supported:

| Method | Env Vars | Auto-refresh | Recommended | |--------|----------|-------------|-------------| | Refresh Token | TAKETIME_REFRESH_TOKEN | Yes | ✅ Best | | Email/Password | TAKETIME_EMAIL + TAKETIME_PASSWORD | Yes | Good | | Access Token | TAKETIME_API_KEY | No (expires ~1h) | For testing |

Refresh Token is the best option — copy it from the app's MCP settings panel. It auto-refreshes indefinitely without exposing your password.

Available Tools — 22 tools

Schedule (blocks)

| Tool | Description | |------|-------------| | list_blocks | List study blocks by date, range, subject, or status | | get_schedule | Full weekly schedule organized by day | | create_block | Schedule a new study block | | update_block | Change time, topic, syllabus topic, repeat daily, mark as done | | delete_block | Remove a study block |

Activities (subjects)

| Tool | Description | |------|-------------| | list_subjects | List all activities with profiles, content items, and counts | | create_subject | Create a new activity (study, training, or routine) | | update_subject | Rename, change color, reorder slots | | add_subject_item | Add syllabus topic, exercise, or micro-habit | | update_subject_item | Update item details (topic, duration, sets, etc.) | | remove_subject_item | Remove an item from a subject | | delete_subject | Delete an activity and all its blocks |

Atomic Habits

| Tool | Description | |------|-------------| | toggle_block_item | Mark/unmark a habit or exercise as done in a block — auto-completes block when all items done |

Statistics & Reports

| Tool | Description | |------|-------------| | get_stats | Completion stats, streaks, heatmap, top subjects | | get_heatmap | 90-day consistency heatmap with intensity levels |

Priority Circle

| Tool | Description | |------|-------------| | get_priorities | View all priority zones (main focus, important, flexible, unallocated) | | add_priority_item | Add an item to a priority zone with pillar and color | | remove_priority_item | Remove an item from the circle | | move_priority_item | Move an item between zones (zone1 max 3) |

Logs & Settings

| Tool | Description | |------|-------------| | get_logs | View recent activity timeline | | get_settings | View user settings (notifications, theme, etc.) | | update_setting | Update a setting value |

Architecture

AI Client (Claude, Cursor, etc.)
     │ stdio
     ▼
Take Time MCP Server (local)
     │ HTTPS
     ▼
Supabase (per-user data, RLS isolated)

• Runs locally on your machine
• Communicates via stdio (JSON-RPC)
• Each user authenticates with their own email/password
• Data is fully isolated per user via Row Level Security (RLS)
• Your data never passes through third-party servers
• Session auto-refreshes — no manual token management needed

Development

# Run with email/password auth
[email protected] TAKETIME_PASSWORD=pass node src/index.js

# Run with access token (for testing)
TAKETIME_API_KEY=your_token node src/index.js

License

MIT