create_calendar
ChatGPTCreate one or more Pocket Informant calendars. Send a calendars array with 1 to 25 objects. Each calendar requires uid and title. Programmatically generated string that starts with MCP_ followed by a UUID. Generate the UUID with your runtime's standard UUID v4 helper. In TypeScript, use import { v4 as uuid } from 'uuid' and call uuid(). In Python, use str(uuid.uuid4()). Example: 'MCP_550e8400-e29b-41d4-a716-446655440000'. title must be a non-empty calendar title. Example: 'Work'. If an optional field is not needed, omit it. Do not send JSON null. When this calendar was created so the user can create an event, use this calendar's uid as that event's required cal value. color uses the Pocket Informant color-string format '{0.541, 0.835, 0.961, 1.000}'. notes, tz, and icon are optional strings. Example calendar: {'uid':'MCP_550e8400-e29b-41d4-a716-446655440000','title':'Work','color':'{0.541, 0.835, 0.961, 1.000}','icon':'calendar'}.
create_context
ChatGPTCreate one or more Pocket Informant contexts. Send a contexts array with 1 to 25 objects. Each context requires uid and title. Programmatically generated string that starts with MCP_ followed by a UUID. Generate the UUID with your runtime's standard UUID v4 helper. In TypeScript, use import { v4 as uuid } from 'uuid' and call uuid(). In Python, use str(uuid.uuid4()). Example: 'MCP_550e8400-e29b-41d4-a716-446655440000'. title must be a non-empty context label. Example: 'Calls'. If an optional field is not needed, omit it. Do not send JSON null. seq is optional and uses integer ordering such as 0 or 10. hidden values are: integer 0 (visible), integer 1 (hidden). Example context: {'uid':'MCP_550e8400-e29b-41d4-a716-446655440000','title':'Calls','seq':0,'hidden':0}.
create_event
ChatGPTCreate one or more Pocket Informant events. Send an events array with 1 to 25 objects. Each event requires uid, title, and cal. Programmatically generated string that starts with MCP_ followed by a UUID. Generate the UUID with your runtime's standard UUID v4 helper. In TypeScript, use import { v4 as uuid } from 'uuid' and call uuid(). In Python, use str(uuid.uuid4()). Example: 'MCP_550e8400-e29b-41d4-a716-446655440000'. title must be a non-empty event title. Example: 'Quarterly planning'. If an optional field is not needed, omit it. Do not send JSON null. Before creating an event, call get_calendars unless the user already specified an existing event calendar ID. cal must be a non-empty existing event calendar ID such as '550e8400-e29b-41d4-a716-446655440001'. If no eligible event calendar exists, ask the user whether they want to create one first; do not create a calendar or event until they confirm. After confirmation, call create_calendar, then use that new calendar's uid as this event's cal value. Do not use InternalNotesCalendarUID, InternalTaskCalendarUID, or InternalTravelCalendarUID for event creation. For timed events, startDate and endDate represent UTC instants. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. For a user-specified timed value, convert the user's local wall time to UTC before sending. for example, 15:00-17:00 in Asia/Kolkata is 09:30-11:30 UTC. startDateTz and endDateTz are display/original-timezone metadata only; they do not convert local wall times to UTC. For all-day events (isAllDay=true), startDate and endDate are calendar dates; use midnight date values and do not shift them with a timezone offset. endDate is inclusive: it must be the user's final requested day, not the following day. for example : For Vacation from August 10 through August 15, use 'startDate':'2026-08-10T00:00:00' and 'endDate':'2026-08-15T00:00:00'. Timezone metadata uses tokens such as '19800|Asia/Kolkata|GMT+5.3'. isAllDay uses true or false. eventStatus values are: integer 0 (Busy), integer 1 (Free), integer 2 (Tentative), integer 3 (Out of Office). sensitivity values are: integer 0 (Normal), integer 1 (Personal), integer 2 (Private), integer 3 (Confidential). tags uses existing tag IDs such as ['550e8400-e29b-41d4-a716-446655440000']. color uses the Pocket Informant color-string format '{0.541, 0.835, 0.961, 1.000}'. recurrence.type values are: string "0" (daily), string "1" (weekly), string "2" (monthly), string "3" (yearly). recurrence.interval is a numeric string. For every two weeks, use recurrence.type='1' and recurrence.interval='2'. recurrence.daysOfWeek values are: integer 1 (Sunday) through integer 7 (Saturday). recurrence.daysOfMonth uses integers 1 through 31. recurrence.monthsOfYear uses integers 1 through 12. recurrence.nthWeekDays entries: dayOfWeek must be a string "1" (Sunday) through string "7" (Saturday). weekNumber must be a string "1" (first) through string "5" (fifth) or string "-1" (last). recurrence.creationTz uses values such as '19800|Asia/Kolkata|IST'. Example event: {'uid':'MCP_550e8400-e29b-41d4-a716-446655440000','title':'Quarterly planning','cal':'550e8400-e29b-41d4-a716-446655440001','startDate':'2026-07-14T09:30:00','startDateTz':'19800|Asia/Kolkata|GMT+5.3','endDate':'2026-07-14T11:30:00','endDateTz':'19800|Asia/Kolkata|GMT+5.3','isAllDay':false,'tags':['550e8400-e29b-41d4-a716-446655440002'],'eventStatus':0,'sensitivity':0,'note':'Bring planning packet'}.
create_note
ChatGPTCreate one or more Pocket Informant notes. Send a notes array with 1 to 25 objects. Each note requires uid and title. Programmatically generated string that starts with MCP_ followed by a UUID. Generate the UUID with your runtime's standard UUID v4 helper. In TypeScript, use import { v4 as uuid } from 'uuid' and call uuid(). In Python, use str(uuid.uuid4()). Example: 'MCP_550e8400-e29b-41d4-a716-446655440000'. title must be a non-empty note title. Example: 'Conference follow-up'. If an optional field is not needed, omit it. Do not send JSON null. cal should be InternalNotesCalendarUID for note creation, including notes with no folder and notes linked to a folder. createdDate, pinToDate, and lastUserModDate represent UTC instants. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. For pinToDate: For a user-specified timed value, convert the user's local wall time to UTC before sending. folder and tags use existing IDs such as '550e8400-e29b-41d4-a716-446655440000' and ['550e8400-e29b-41d4-a716-446655440000']. flagged values are: integer 0 (not flagged), integer 1 (flagged). Example note: {'uid':'MCP_550e8400-e29b-41d4-a716-446655440000','title':'Conference follow-up','cal':'InternalNotesCalendarUID','note':'Email venue and speakers','folder':'550e8400-e29b-41d4-a716-446655440000','tags':['550e8400-e29b-41d4-a716-446655440001'],'flagged':1,'createdDate':'2026-05-17T09:30:00','lastUserModDate':'2026-05-17T09:30:00','pinToDate':'2026-05-18T08:00:00'}.
create_project
ChatGPTCreate one or more Pocket Informant projects. Send a folders array with 1 to 25 objects. Each project requires uid and title. Programmatically generated string that starts with MCP_ followed by a UUID. Generate the UUID with your runtime's standard UUID v4 helper. In TypeScript, use import { v4 as uuid } from 'uuid' and call uuid(). In Python, use str(uuid.uuid4()). Example: 'MCP_550e8400-e29b-41d4-a716-446655440000'. title must be a non-empty project name. Example: 'Health Admin'. If an optional field is not needed, omit it. Do not send JSON null. type is optional and uses Pocket Informant project-type values: integer 0 (Parallel), integer 1 (Sequential(GTD)), integer 2 (Single Action). autoComp values are: integer 0 (off), integer 1 (on). Use integer 1 to enable auto-complete; use integer 0 or omit when auto-complete is off. dueDate and compDate represent UTC instants. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. For a user-specified timed value, convert the user's local wall time to UTC before sending. color uses the Pocket Informant color-string format '{0.541, 0.835, 0.961, 1.000}'. seq is the project ordering value. cal is optional and may use values such as InternalTaskCalendarUID, but project membership for tasks is controlled by the task project field. Example project: {'uid':'MCP_550e8400-e29b-41d4-a716-446655440000','title':'Health Admin','seq':0,'type':1,'autoComp':1,'color':'{0.541, 0.835, 0.961, 1.000}'}.
create_tag
ChatGPTCreate one or more Pocket Informant tags. Send a tags array with 1 to 25 objects. Each tag requires uid and title. Programmatically generated string that starts with MCP_ followed by a UUID. Generate the UUID with your runtime's standard UUID v4 helper. In TypeScript, use import { v4 as uuid } from 'uuid' and call uuid(). In Python, use str(uuid.uuid4()). Example: 'MCP_550e8400-e29b-41d4-a716-446655440000'. title must be a non-empty label. Example: 'Work'. If an optional field is not needed, omit it. Do not send JSON null. color is optional and should use Pocket Informant's color-string format: '{r, g, b, a}' with normalized decimal channels. Example: '{0.541, 0.835, 0.961, 1.000}'. icon is optional text or emoji. Example: '⭐'. Example tag: {'uid':'MCP_550e8400-e29b-41d4-a716-446655440000','title':'Work','color':'{0.541, 0.835, 0.961, 1.000}','icon':'⭐'}.
create_task
ChatGPTCreate one or more Pocket Informant tasks. Use this when the user wants a task, subtask, checklist parent, or checklist child. Send a tasks array with 1 to 25 task objects. Each task requires uid and title. Programmatically generated string that starts with MCP_ followed by a UUID. Generate the UUID with your runtime's standard UUID v4 helper. In TypeScript, use import { v4 as uuid } from 'uuid' and call uuid(). In Python, use str(uuid.uuid4()). Example: 'MCP_550e8400-e29b-41d4-a716-446655440000'. title must be a non-empty task title. Example: 'Call dentist'. If an optional field is not needed, omit it. Do not send JSON null. Use [] for an empty tags array. project, context, parent, tags, status, and assignedTo must use existing Pocket Informant IDs. Use project to place the task inside a project. If the task belongs to Inbox, do not send project. For a top-level task intended for Inbox or another non-project task list, must set cal='InternalTaskCalendarUID'. parent creates the child relationship. A task with no parent is a top-level task. type=1 means checklist mode. A top-level checklist parent uses type=1 and omits parent. A checklist child uses both parent and type=1. A normal subtask uses parent and omits type. Checklist parents with checklist children, and normal parents with subtasks, can be created in the same create_task call by setting each child parent to the parent task's caller-supplied MCP_... uid from that same request. Timed startDate and dueDate values and every compDate represent UTC instants. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. For a user-specified timed value, convert the user's local wall time to UTC before sending. For date-only values, use 2026-05-17T00:00:00 for a start date and 2026-05-17T23:59:59 for a due date. Date-only values represent calendar dates and must not be shifted by a timezone offset. startDateHasTime and dueDateHasTime values are: integer 0 (date-only), integer 1 (time portion meaningful). recurrenceType values are: integer 0 (after due date), integer 1 (after completion), integer 2 (after start date), integer 3 (with parent). recurrence.type values are: string "0" (daily), string "1" (weekly), string "2" (monthly), string "3" (yearly). recurrence.interval is a numeric string. For every two weeks, use recurrence.type='1' and recurrence.interval='2'. recurrence.daysOfWeek values are: integer 1 (Sunday) through integer 7 (Saturday). recurrence.daysOfMonth uses integers 1 through 31. recurrence.monthsOfYear uses integers 1 through 12. recurrence.nthWeekDays entries: dayOfWeek must be a string "1" (Sunday) through string "7" (Saturday). weekNumber must be a string "1" (first) through string "5" (fifth) or string "-1" (last). recurrenceRefId is the recurrence series ID. For the first task in a recurring series, use the same value as uid. action values are: integer 0 (None), integer 1 (Next Action), integer 2 (Active), integer 3 (Planning), integer 4 (Delegated), integer 5 (Waiting), integer 6 (Hold), integer 7 (Postponed), integer 8 (Someday), integer 9 (Cancelled), integer 10 (Reference). priority values are: integer 0 (None), integer 1 (Top), integer 5 (High), integer 10 (Medium), integer 15 (Low). flagged values are: integer 0 (not flagged), integer 1 (flagged). sensitivity values are: integer 0 (Normal), integer 1 (Personal), integer 2 (Private), integer 3 (Confidential). complete values are: integer 0 (incomplete), integer 100 (complete). color uses the Pocket Informant color-string format '{0.541, 0.835, 0.961, 1.000}'. Example Inbox task: {'uid':'MCP_550e8400-e29b-41d4-a716-446655440000','title':'Review support case','cal':'InternalTaskCalendarUID','complete':0}. Example task: {'uid':'MCP_550e8400-e29b-41d4-a716-446655440000','title':'Call dentist','dueDate':'2026-05-17T09:30:00','dueDateHasTime':1,'project':'project-uid','tags':['ta…
get_calendars
ChatGPTGet Pocket Informant calendars. Use this when you need valid calendar IDs before creating or filtering events, when you need a paginated calendar list, or when you need deleted calendar IDs for sync. Use repeated id values to fetch specific calendars. Example: id=["550e8400-e29b-41d4-a716-446655440000"]. Use bucketSize and offset for pagination. Use modAfter with a UTC instant such as 2026-05-17T09:30:00 for incremental reads. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. Use deleted="1" to return deleted calendar IDs instead of calendar objects. For event creation, use a calendar other than InternalNotesCalendarUID, InternalTaskCalendarUID, or InternalTravelCalendarUID. Before create_event, call this tool unless the user already specified an existing event calendar ID. If no eligible event calendar exists, ask the user whether they want to create a calendar first. Do not create a calendar or event until they confirm.
get_contexts
ChatGPTGet Pocket Informant contexts. Use this when you need valid context IDs before creating or filtering tasks, when you need a paginated context list, or when you need deleted context IDs for sync. Use repeated id values to fetch specific contexts. Example: id=["550e8400-e29b-41d4-a716-446655440000"]. Use bucketSize and offset for pagination. Use modAfter with a UTC instant such as 2026-05-17T09:30:00 for incremental reads. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. Use deleted="1" to return deleted context IDs instead of context objects.
get_events
ChatGPTGet Pocket Informant events. Use this when you need existing event IDs, event details, filtered event lists, or deleted event IDs for sync. Use repeated id values to fetch specific events. Example: id=["550e8400-e29b-41d4-a716-446655440000"]. Use bucketSize and offset for pagination. Use modAfter with a UTC instant such as 2026-05-17T09:30:00 for incremental reads. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. Use deleted="1" to return deleted event IDs instead of event objects.
get_folders
ChatGPTGet Pocket Informant projects. Use this when you need project IDs before creating or filtering tasks, when you need a paginated project list, or when you need deleted project IDs for sync. Pocket Informant stores projects under the folders collection and returns them in the folders field. Use repeated id values to fetch specific projects. Example: id=["550e8400-e29b-41d4-a716-446655440000"]. Use bucketSize and offset for pagination. Use modAfter with a UTC instant such as 2026-05-17T09:30:00 for incremental reads. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. Use deleted="1" to return deleted project IDs instead of project objects.
get_notes
ChatGPTGet Pocket Informant notes. Use this when you need existing note IDs, note details, paginated note lists, or deleted note IDs for sync. Use repeated id values to fetch specific notes. Example: id=["550e8400-e29b-41d4-a716-446655440000"]. Use bucketSize and offset for pagination. Use modAfter with a UTC instant such as 2026-05-17T09:30:00 for incremental reads. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. Use deleted="1" to return deleted note IDs instead of note objects.
get_tags
ChatGPTGet Pocket Informant tags. Use this when you need valid tag IDs before creating or filtering tasks, when you need a paginated tag list, or when you need deleted tag IDs for sync. Use repeated id values to fetch specific tags. Example: id=["550e8400-e29b-41d4-a716-446655440000"]. Use bucketSize and offset for pagination. Use modAfter with a UTC instant such as 2026-05-17T09:30:00 for incremental reads. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. Use deleted="1" to return deleted tag IDs instead of tag objects.
get_tasks
ChatGPTGet Pocket Informant tasks. Use this when you need existing task IDs, task details, paginated task lists, or deleted task IDs for sync. Use repeated id values to fetch specific tasks. Example: id=["550e8400-e29b-41d4-a716-446655440000"]. Use bucketSize and offset for pagination. Use modAfter with a UTC instant such as 2026-05-17T09:30:00 for incremental reads. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. Use compAfter with a UTC instant such as 2026-05-17T09:30:00 to fetch tasks completed after that instant. Naive Pocket Informant datetime strings are interpreted as UTC, not as local wall time. Do not combine compAfter with modAfter. Use order with a task sort key such as -lastUpdated. Use folder, context, action, noDueDate, and flagged as standalone task filters. folder filters by project UID. Example: 550e8400-e29b-41d4-a716-446655440000. Use folder="null" to filter tasks with no project. context filters by context UID. Example: 550e8400-e29b-41d4-a716-446655440000. Use context="null" to filter tasks with no context. Use action with numeric string values such as "1", or action="null" for tasks with no action. Use flagged with numeric string values such as "1", or flagged="null" for tasks with no flagged value. Use noDueDate="1" for tasks with no due date. Use deleted="1" to return deleted task IDs instead of task objects.
render_service_status
ChatGPTRender the Pocket Informant MCP status widget. Call service_status first.
service_status
ChatGPTReturns basic status information for the Pocket Informant MCP service.
