Pocket Informant

Create 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`. `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_calendar

Create 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_context

Create one or more Pocket Informant events. Send an `events` array with 1 to 25 objects. Each event 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 event title. Example: 'Quarterly planning'. If an optional field is not needed, omit it. Do not send JSON `null`. When creating an event, use `cal` with an existing event calendar ID such as '550e8400-e29b-41d4-a716-446655440001'. 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_event

Create 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_note

Create 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_project

Create 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_tag

Create 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':['tag-uid'],'action':1,'priority':5,'complete':0}. Example checklist parent: {'uid':'MCP_550e8400-e29b-41d4-a716-446655440000','title':'Prepare for dentist visit','type':1,'project':'project-uid','complete':0}. Example checklist child: {'uid':'MCP_2f1d6b7d-91d0-4b2e-a0a0-2af0b9ec1f9a','title':'Confirm insurance details','parent':'MCP_550e8400-e29b-41d4-a716-446655440000','type':1,'complete':0}. Example subtask: {'uid':'MCP_7a645b78-6a54-4d20-a3d6-7ab66208ff01','title':'Bring previous prescription','parent':'MCP_550e8400-e29b-41d4-a716-446655440000','complete':0}.

create_task

Get 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`.

get_calendars

Get 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_contexts

Get 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_events