> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asksimon.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Productivity

> Contacts, files, calendar, and email across Google and Microsoft.

### Create Contact `create_contact`

Save a new contact to your connected address book. Ask Simon to add someone and it creates the contact, confirming the details first.

| Parameter               | Type                      |
| ----------------------- | ------------------------- |
| `business_phones` *opt* | `string[]`                |
| `company_name` *opt*    | `string`                  |
| `department` *opt*      | `string`                  |
| `display_name` *opt*    | `string`                  |
| `email_addresses` *opt* | `object[]`                |
| `given_name` *opt*      | `string`                  |
| `job_title` *opt*       | `string`                  |
| `mobile_phone` *opt*    | `string`                  |
| `office_location` *opt* | `string`                  |
| `personal_notes` *opt*  | `string`                  |
| `surname` *opt*         | `string`                  |
| `title` *opt*           | `string`                  |
| `vendor` *opt*          | `enum(microsoft, google)` |

### Edit Spreadsheet `spreadsheet_edit`

Edit an existing Excel workbook in your connected cloud drive in place, updating cells, formulas, rows, tables, or worksheets while preserving the rest of the file. Describe the change and Simon makes it.

| Parameter                 | Type                      |
| ------------------------- | ------------------------- |
| `operations` **required** | `any[]`                   |
| `name` *opt*              | `string`                  |
| `ref` *opt*               | `object`                  |
| `url` *opt*               | `string`                  |
| `vendor` *opt*            | `enum(microsoft, google)` |

### Export File to Location `file_export_to_location`

Save a document or spreadsheet Simon created to a folder in your connected cloud drive, such as a shared SharePoint or OneDrive location. Ask Simon to deliver a finished file and it writes it there.

| Parameter                  | Type                      |
| -------------------------- | ------------------------- |
| `artifact_id` **required** | `string`                  |
| `destination` *opt*        | `string`                  |
| `destination_ref` *opt*    | `object`                  |
| `filename` *opt*           | `string`                  |
| `vendor` *opt*             | `enum(microsoft, google)` |

### Get Calendar Event `calendar_get_event`

Get the full details of a calendar event, including attendees, responses, agenda, and description. Ask Simon about a specific meeting and it returns the complete event.

| Parameter               | Type     |
| ----------------------- | -------- |
| `event_id` **required** | `string` |

### Get Email Attachment `email_get_attachment`

Retrieve the contents of an email attachment. Ask Simon to open or pull a file attached to an email and it returns the attachment.

| Parameter                    | Type     |
| ---------------------------- | -------- |
| `attachment_id` **required** | `string` |

### Get Email Thread `email_get_thread`

Get the full conversation of an email thread, including every message. Ask Simon for the complete context of an email discussion and it returns the whole thread.

| Parameter                   | Type      |
| --------------------------- | --------- |
| `thread_id` **required**    | `string`  |
| `include_attachments` *opt* | `boolean` |

### List Calendar Events `list_calendar_events`

See what is on your calendar in a given time window. Ask Simon about your schedule, meetings, or free time and it lists the relevant events.

| Parameter            | Type                      |
| -------------------- | ------------------------- |
| `end` **required**   | `string`                  |
| `start` **required** | `string`                  |
| `calendar` *opt*     | `string`                  |
| `max_results` *opt*  | `integer`                 |
| `query` *opt*        | `string`                  |
| `vendor` *opt*       | `enum(microsoft, google)` |

### List Emails `list_emails`

Find emails by attributes like folder, date, sender, recipient, attachments, or read state. Ask Simon to pull messages matching those filters and it lists them.

| Parameter               | Type                             |
| ----------------------- | -------------------------------- |
| `end` *opt*             | `string`                         |
| `folder` *opt*          | `enum(inbox, sent, drafts, all)` |
| `from_address` *opt*    | `string`                         |
| `has_attachments` *opt* | `boolean`                        |
| `is_unread` *opt*       | `boolean`                        |
| `mailbox` *opt*         | `string`                         |
| `max_results` *opt*     | `integer`                        |
| `query` *opt*           | `string`                         |
| `start` *opt*           | `string`                         |
| `to_address` *opt*      | `string`                         |
| `vendor` *opt*          | `enum(microsoft, google)`        |

### Read Drive Link `read_drive_link`

Open a file or list a folder from a shared cloud drive link, such as a SharePoint, OneDrive, or Google Drive URL. Paste a link and ask Simon to read it.

| Parameter          | Type      |
| ------------------ | --------- |
| `url` **required** | `string`  |
| `max_chars` *opt*  | `integer` |

### Search Contacts `search_contacts`

Look up people in your connected address book by name, email, or company. Ask Simon for someone's saved contact details and it finds them.

| Parameter           | Type                      |
| ------------------- | ------------------------- |
| `email` *opt*       | `string`                  |
| `max_results` *opt* | `integer`                 |
| `query` *opt*       | `string`                  |
| `vendor` *opt*      | `enum(microsoft, google)` |

### Update Contact `update_contact`

Update the details of a contact already in your connected address book. Ask Simon to change someone's saved information and it updates the contact.

| Parameter               | Type                      |
| ----------------------- | ------------------------- |
| `business_phones` *opt* | `string[]`                |
| `company_name` *opt*    | `string`                  |
| `contact_id` *opt*      | `string`                  |
| `department` *opt*      | `string`                  |
| `display_name` *opt*    | `string`                  |
| `email_addresses` *opt* | `object[]`                |
| `given_name` *opt*      | `string`                  |
| `job_title` *opt*       | `string`                  |
| `mobile_phone` *opt*    | `string`                  |
| `office_location` *opt* | `string`                  |
| `personal_notes` *opt*  | `string`                  |
| `ref` *opt*             | `object`                  |
| `surname` *opt*         | `string`                  |
| `title` *opt*           | `string`                  |
| `vendor` *opt*          | `enum(microsoft, google)` |