MCP App Store
by KeenEthics
Shovel icon

Shovel MCP Server for Claude and ChatGPT

By Shovel

Overview

Shovel is a study planner for college students. It shows how much free time you have before each deadline and plans your study sessions around your classes, work and the rest of your life. Connect your Shovel account to: - Ask what to work on next, based on your deadlines and how much free time is left before each one - Add assignments, readings and exams from a syllabus, PDF or list, with due dates and time estimates - Build your weekly schedule: classes, activities and other regular commitments - Plan your week in one message: Shovel's Auto-plan puts your study sessions on your calendar - Move or remove study sessions, log time you studied and run a study timer - See your calendar and your progress When you connect, you choose whether Claude can only view your Shovel or also make changes. Changes show up in Shovel right away, and most deleted items can be restored for 30 days in Shovel (Settings, AI assistants). Requires a Shovel account.

How to connect

  1. Claude: Open the Shovel listing in the Claude connectors directory and choose Connect. Claude listing Shovel exposes 29 tools here.
  2. ChatGPT: Open the Shovel listing in the ChatGPT app directory and choose Connect. ChatGPT listing Shovel exposes 29 tools here.

Tools

auto_plan

ChatGPT
Plan study time with Shovel's own Auto-plan, exactly like the Plan button: fits tasks into free study time using the student's preferences (session length, breaks, preferred times, days off, daily max), start dates and deadlines. When the student asks for a plan, run it with apply: true and say which task landed on which day and time and what won't fit; leave apply off only if they ask to see a plan before it's saved. Leave startDate out unless the student names a first day, so the plan begins today. replan (default true) replaces sessions Shovel planned earlier in these dates; the student's own upcoming sessions are never moved. Missed sessions (ended, time not logged) of the tasks it plans come off the calendar, since their time is in the new plan. Up to 31 days.

change_study_session

ChatGPT
Move a planned study session (start), change its length (minutes) or its notes.

create_course_or_activity

ChatGPT
Add a course or an activity (a colour is picked if none is given; defaultDurationMinutes is how long its time usually is). Then add its times with create_events. Sending it again adds a second one: if a call fails or you're not sure it went through, check list_courses_and_activities first.

create_events

ChatGPT
Add a whole timetable at once (up to 200 event definitions; each can repeat all term). Class and activity times: pass courseOrActivityId. Repeats: weekly (repeatOnDays + repeatUntil), every other week for A/B weeks (repeatEveryWeeks: 2), or only on chosen dates (repeatOnDates) for A-day/B-day rotations and block schedules (leave out break days from get_term, and ask whether the rotation continues or restarts after a break). Returns a batchId. Sending the same events again adds them twice: if a call fails or you're not sure it went through, check get_calendar first.

create_tasks

ChatGPT
Add tasks: one call per course (up to 500), e.g. from a syllabus (call get_syllabus_guide first), PDF or CSV, or just one. Give each its due date WITH time, category and estimate (readings: readingSource and pages instead, Shovel estimates from them; start-ahead days follow the estimate). If a date could mean two days, like 'next Friday' while this week's Friday is still ahead, ask which one first. A task without an estimate takes its category's default estimate, if the student set one; the rest are turned back until the student says they don't know yet (noEstimateYet). Tasks already in Shovel (same course, name and due date) are skipped, so resending is safe. Due on many dates (a weekly quiz): one task per date. Returns a batchId; remove_added_batch takes the import back.

delete_course_or_activity

ChatGPT
Permanently delete a course or activity with all its tasks and times. Two steps: the first call returns a warning and confirmToken; call again with it only after the student clearly agrees. Can't be restored.

delete_events

ChatGPT
Delete up to 10 calendar events. Give each event's id AND exact title; a mismatch deletes nothing. Repeating events: one occurrence by default (pass occurrenceStart); this_and_following or all only when the student clearly asks. Restorable for 30 days.

delete_tasks

ChatGPT
Delete up to 10 tasks. Give each task's id AND its exact current name; a mismatch deletes nothing. The student can restore them for 30 days. Confirm with the student first.

edit_tasks

ChatGPT
Give many tasks each their own new values (up to 300): name (e.g. to follow a format), dueDate with time (null removes it), estimateMinutes, priority, startAheadDays, details, and for readings readingSource (the book or article) and pages or pageCount, which replace its pages and set its estimate and start from them; durationMinutes (how long an exam lasts); addSubtasks, completeSubtaskIds, reopenSubtaskIds, removeSubtaskIds and status (to_do, completed, do_later). Use it for one task too, and for 'move each quiz to the Friday of its week', 'rename these to …' or 'add the pages to my readings'. For the SAME change on many tasks use update_tasks. Only the fields you pass change.

get_calendar

ChatGPT
The student's calendar for a date range (default: the next 7 days): classes, activities and events (with commute minutes before/after, which are busy too), plus planned study sessions. Events with busy false don't block study time.

get_cushion_timeline

ChatGPT
The Cushion chart in numbers, week by week: tasks and hours of work due each week, the lowest cushion (free study time left before a deadline once earlier work is done) and how many tasks are short of time, plus the crunch week, the busiest week and the first shortfall. Use it for 'when's my busiest week?', 'can I take on more?' or before planning ahead.

get_overview

ChatGPT
Start here. The student's current term, today's and tomorrow's classes, events and planned study sessions, overdue tasks, the next to-do tasks, and their workload cushion (free study time left before deadlines), in one call.

get_progress

ChatGPT
How the student is doing: workload cushion, study time used and still needed by course, GPA, and the study timer if one is running or paused.

get_syllabus_guide

ChatGPT
Shovel's rules for turning a syllabus, course schedule or reading list into tasks, as its own Import syllabus does. Call it BEFORE adding tasks from any syllabus, and follow it.

get_task

ChatGPT
Everything about one task (taskId): details, subtasks, estimate, planned study sessions. Or one study session (plannedTaskId): its task, time, length and whether the time was used.

get_term

ChatGPT
The term: start date, last day of classes, last day of exams, time zone, breaks and the minimum study block length.

list_courses_and_activities

ChatGPT
The student's courses and activities (ids, names) for this term. With courseId: that course in full, its task categories (with the student's default estimate for each task in one, where set), reading sources and grades.

list_tasks

ChatGPT
Tasks, by view: to_do (default), overdue, completed, no_due_date, start_soon, recently_created, on_date or plannable_in_range. Or filter the whole term (courseId, category, search, dueFrom/dueTo) to find e.g. every Math quiz before planning or editing them in bulk. Each task has its id, course, due date, estimate (timeNeed, minutes), time already planned and used, and cushion.

log_time

ChatGPT
Log study time the student already did (up to 50 entries). For time on a planned session, give plannedTaskId (and minutes and pages if they differ; used=false takes it back). For time without one ('I just studied the essay for 40 minutes'), give taskId and minutes: it goes on the calendar as a used session, as logging time in Shovel does. Either way it counts toward the task. Readings need pages. Time without a planned session is added again if sent again: if a call fails or you're not sure it went through, check get_calendar first.

plan_study_sessions

ChatGPT
For a general request like 'plan my week' use auto_plan; this tool is for when the student names the days or times. Put many study sessions on the calendar at once at exact times (up to 500), e.g. every Math quiz the Monday night before it's due. Find the tasks first with list_tasks filters. Overlaps with classes, events, commutes or other sessions, and sessions outside the student's awake time, are reported, not blocked. Returns a batchId. Sending the same sessions again adds them again: if a call fails or you're not sure it went through, check get_calendar first.

remove_added_batch

ChatGPT
Take back a bulk add this app made in the last 7 days (create_tasks, plan_study_sessions or create_events), by its batchId. Tasks the student completed or logged time on are kept. The student can still restore what was removed from Shovel's Settings.

set_awake_times

ChatGPT
Set when the student wakes up and how many hours they're awake (shapes free study time): the same every day with wakeUp, or different on some days with days, e.g. 11:00 on weekends: days [{days: [SA, SU], wakeUp: '11:00'}]. Days not mentioned keep their current awake time; a day given only a wakeUp keeps its hours awake, so its bedtime moves too: ask whether bedtime stays the same, and if so pass awakeHours. Replaces the awake blocks for the whole term, including one-off changes made on the calendar.

set_up_term

ChatGPT
Set up the student's term: dates, time zone, wake-up time and awake hours, breaks. Use it for a brand-new student (Shovel's setup screens are then done) or to change term dates. newTerm: true starts the next semester as the current one (confirm with the student first; the old term stays). Ask for anything you don't know rather than guessing, especially dates and wake-up time. The term starts two weeks before it's set up, as in the app; that's not changed here.

study_timer

ChatGPT
Start, pause or resume, stop (keeps the time) or cancel the study timer for a study session.

unplan_study_sessions

ChatGPT
Remove up to 10 planned study sessions from the calendar (the tasks stay). Give each session id AND its task's exact name. Restorable for 30 days.

update_course_or_activity

ChatGPT
Change a course or activity: name or colour (its class times follow), defaultDurationMinutes (how long its time usually is), a course's notes (replaces them: to add, send the old notes too), or categoryEstimates: a task category's default estimate, the student's own time for each task in it (Shovel shows "1h each"; a new task in it with no estimate takes it).

update_event

ChatGPT
Change a calendar event: time, title, location, description, commute before or after (0 removes it), busy (false: free time, study can be planned over it), colour, or its repeat (repeatOnDays + repeatUntil, repeatEveryWeeks, or repeatOnDates; a one-off event can start repeating). For a repeating event pass occurrenceStart and scope (this, this_and_following, all); a new repeat needs this_and_following or all. Only the fields you pass change.

update_planning_preferences

ChatGPT
Change how Auto-plan schedules study time. Fields: style (spread, ahead, deadline), shape (even, rampUp, taperDown), idealSession (15-480 min), finishDaysAhead (0-7), deepBreakMinutes, smallBreakMinutes, eventBreakMinutes, startAfterWakingMinutes, stopBeforeBedMinutes, preferredTime ([morning, afternoon, evening]), daysOff ([mon..sun]), maxDailyMinutes (30-1440 or null), addReviews, whenShort (dueFirst, startFirst, shareTime).

update_tasks

ChatGPT
Change many tasks at once, like multi-select in Shovel's task list: pick them by taskIds or by select (e.g. {courseId, category: 'Quiz'} for every Math quiz), then set any of: estimateMinutes, priority, startAheadDays, dueDate (YYYY-MM-DD), dueTime (HH:MM), pushDueDays, moveToCourseId, category, status (completed, do_later, to_do). Up to 300 tasks a call.

auto_plan

Claude

change_study_session

Claude

create_course_or_activity

Claude

create_events

Claude

create_tasks

Claude

delete_course_or_activity

Claude

delete_events

Claude

delete_tasks

Claude

edit_tasks

Claude

get_calendar

Claude

get_cushion_timeline

Claude

get_overview

Claude

get_progress

Claude

get_syllabus_guide

Claude

get_task

Claude

get_term

Claude

list_courses_and_activities

Claude

list_tasks

Claude

log_time

Claude

plan_study_sessions

Claude

remove_added_batch

Claude

set_awake_times

Claude

set_up_term

Claude

study_timer

Claude

unplan_study_sessions

Claude

update_course_or_activity

Claude

update_event

Claude

update_planning_preferences

Claude

update_tasks

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/shovel"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/shovel)