> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taketime.space/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome to Take Time — Study Planner API & MCP

> Take Time is a personal study planner PWA with a REST API and MCP Server. Manage your schedule, subjects, and progress with code or AI.

Take Time is a **personal study planner** that helps students organize their time using study blocks, intelligent scheduling, and visual progress tracking. Beyond the app itself, Take Time exposes a full **REST API** and an **MCP Server** so you can automate your schedule, build integrations, or control everything through an AI assistant like Claude or Cursor — using plain English.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get up and running in under 5 minutes
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Full REST API documentation
  </Card>

  <Card title="MCP Server" icon="bolt" href="/mcp/overview">
    Connect your AI assistant to Take Time
  </Card>

  <Card title="Authentication" icon="lock" href="/authentication">
    Learn how to authenticate your requests
  </Card>
</CardGroup>

## What you can do

<CardGroup cols={3}>
  <Card title="Study Blocks" icon="calendar">
    Create, edit, and complete study blocks with subjects and topics
  </Card>

  <Card title="Activities" icon="book-open">
    Manage study subjects, training routines, and daily habits
  </Card>

  <Card title="Smart Schedule" icon="clock">
    Weekly schedule with automatic slot management
  </Card>

  <Card title="Progress Tracking" icon="chart-line">
    Heatmaps, streaks, and completion rates
  </Card>

  <Card title="Syllabus" icon="list-check">
    Track topics, exercises, and micro-habits per activity
  </Card>

  <Card title="AI Integration" icon="robot">
    Manage everything through natural language via MCP
  </Card>
</CardGroup>

## Design principles

<AccordionGroup>
  <Accordion title="Intention-based API">
    The API is designed around **what you want to do**, not the underlying data model.
    `create_block` takes a subject name and time — the API handles the rest.
  </Accordion>

  <Accordion title="Consistent responses">
    Every endpoint returns the same shape: `{ data, error, meta }`.
    No surprises, no guessing.
  </Accordion>

  <Accordion title="Offline-first app">
    The Take Time app works offline and syncs automatically when you reconnect.
    The API always reflects the latest synced state.
  </Accordion>
</AccordionGroup>

## Getting started

<Steps>
  <Step title="Create an account">
    Sign up at [taketime.app](https://taketime.app) and set up your first activities.
  </Step>

  <Step title="Generate an API key">
    Go to **Settings** in the app and generate your API key under the **Developer** section.
  </Step>

  <Step title="Choose your integration">
    Use the **REST API** directly or install the **MCP Server** for AI-powered management.
  </Step>

  <Step title="Start building">
    Follow the [Quickstart](/quickstart) guide to make your first API call in minutes.
  </Step>
</Steps>