Events

Calendar: what is scheduled, and when you are free

Calling it

This is your own data, so a call has to say who you are. Make a token at /token and send it as a header.

curl -H "Authorization: Bearer $MU_TOKEN" \
  https://mu-mcp.yvangodard.me/api/v1/events/list

How every call behaves →

Methods

POST /api/v1/events/create

Schedule a reminder or event at a given time; optionally repeating, and optionally running a prompt through the agent when it fires

Needs an account. Changes something, so POST only.

Argument	Type	Description
`title` *	string	What to be reminded about, e.g. 'Call the dentist'
`when` *	string	When to fire, RFC3339 with timezone offset, e.g. 2026-07-22T15:00:00+01:00
`note`	string	Optional extra detail
`minutes`	number	How long it lasts in minutes (default 30)
`repeat`	string	How often it recurs: hourly, daily, weekly or monthly. Omit for once
`prompt`	string	Optional instruction to run through the agent when it fires, e.g. "brief me on today's news". The answer is mailed to you

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"title","when":"when"}' \
  https://mu-mcp.yvangodard.me/api/v1/events/create

title *when *noteminutesrepeatprompt

POST /api/v1/events/delete

Cancel an event by id

Needs an account. Changes something, so POST only. Withheld from the agent — a person or a program only.

Argument	Type	Description
`id` *	string	The event's id, as given by events_list

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"id"}' \
  https://mu-mcp.yvangodard.me/api/v1/events/delete

id *

GET /api/v1/events/free

Find when the caller has nothing booked — open slots of a given length, within working hours

Needs an account.

Argument	Type	Description
`from`	string	Start of the window to search, RFC3339, e.g. 2026-08-03T00:00:00+01:00. Defaults to now
`to`	string	End of the window, RFC3339. Defaults to a week after from
`minutes`	number	How long a slot you need, in minutes (default 30)
`day_start`	number	Earliest hour of the day to offer, 0-23 (default 9)
`day_end`	number	Latest hour of the day to offer, 0-23 (default 18)

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://mu-mcp.yvangodard.me/api/v1/events/free"

fromtominutesday_startday_end

GET /api/v1/events/list

List the caller's upcoming events and reminders, each with its id

Needs an account.

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://mu-mcp.yvangodard.me/api/v1/events/list"

The same methods are tools over MCP, and every service on this instance is in one reference. Same method, same answer, same price.