Read Tools
Read tools retrieve data from your Take Time account without making any changes. Use these when you want to review your schedule, check your progress, or look up subjects.list_blocks
Retrieve study blocks from your schedule with optional filters. Use this to see what’s planned for a specific date, subject, or completion status.
Returns: An array of block objects. Each block includes
id, subject_id, subject_name, date, start, end, topic, and done.
list_subjects
List all activity profiles configured in your Take Time account. Subjects define the subjects, activities, and time slots that make up your schedule.
Returns: An array of subject objects. Each subject includes
id, name, type, color, and a slots array describing its recurring time slots.
get_stats
Fetch completion statistics, your current streak, and the per-day activity heatmap for a given period. This is the same data that powers the progress view in the Take Time app.
Returns: A stats object with the following fields:
get_schedule
Retrieve the full weekly schedule for any week, including all blocks organized by day. Use a week_offset to look at past or future weeks.
Returns: A weekly schedule object with
week_start, week_end, and a days array. Each day contains its date, label, and an array of blocks.
Write Tools
Write tools create or modify data in your Take Time account. Your AI assistant will typically confirm the details with you before calling a write tool, but you can also ask it to act immediately.create_block
Schedule a new study block on a specific date and time.
Returns: The newly created block object including its assigned
id.
update_block
Modify an existing study block. Use this to reschedule a block, update its topic, or mark it as done.
Returns: The updated block object reflecting all applied changes.
create_subject
Create a new activity profile. Subjects are the building blocks of your schedule — each one represents a subject, project, or recurring activity.
Returns: The newly created subject object including its assigned
id.
suggest_schedule
Request AI-generated schedule recommendations based on your completion history, stated goal, and available time. Suggestions are not applied automatically — review them and use create_block or update_block to act on the ones you want.
Returns: An array of schedule recommendation objects, each with a
type (add_block, move_block, remove_block, or rebalance), the target subject_id, day, proposed start and end times, and a reason explaining the suggestion.
Delete Tools
delete_block
Permanently remove a study block from your schedule.
Returns: A success confirmation object with the deleted block’s
id and a deleted: true flag.