Keep It Shortcuts Support

Keep It provides actions to the Shortcuts app in version 1.7 or later on iOS / iPadOS 13 or later, and Keep It 1.11.5 or later on macOS 12 Monterey or later.

To see these actions in the Shortcuts app, select Keep It in the list of apps shown when adding actions to a shortcut. After dragging the action to the shortcut, expand it to see all the options it supports.

Most actions return a Keep It item or list, and either those or their properties can then be used in further actions.

Adding Items

• Add Files: Adds the specified files. Optionally specify a destination, tags, and whether to convert text files to notes. Returns the created items.
• Add List: Add a folder or bundle. Returns the folder or bundle.
• Add Text: Creates a new item from the text. Optionally specify a destination, format, style for the next (notes only), and tags. Returns the new item.
• Add Web Link: Adds a web link. Optionally set a name for the saved web link, choose whether to save it for offline and in what format, the destination and tags. Returns the new item.

Working with Notes and Text Files

• Append Text: Append text to a note or editable text item in Keep It. For notes, choose the style of the text to add. Returns the item.
• Append Link: Append a link to a note or editable text item in Keep It. Introduced in Keep It 2.8 (the Add Web Link action can achieve the same thing in earlier versions by specifying an item as the target).
• Attach Files: Attach a file to a note or editable text item. Returns the item.
• Get Text Content: Gets the plain text content of any note or editable text item in Keep It.

Finding Items and Lists

• Find Items based on configurable filters, including by names and dates, and sort the results.
• Get Items in Folder supplements the Find items query by allowing you to specify whether or not to include items in nested folders and bundles.
• Find Lists based on configurable filters that can match names, parent folder and colors.
• Find Labels by their name or color.
• Get Item: Get a specific Keep It item, optionally by its item link or identifier. Useful for integrating shortcuts with other automation methods such as AppleScript or x-callback-urls.
• Get Label: Get a specific Keep It label, optionally by its identifier or URL. Useful for integrating shortcuts with other automation methods such as AppleScript or x-callback-urls.
• Get List: Get a specific Keep It list, optionally by its identifier or URL. Useful for integrating shortcuts with other automation methods such as AppleScript or x-callback-urls.

Working with Lists

• Rename List: Rename folders and bundles
• Change List Color: Change the color of a folder or bundle
• Move List: Move a folder or bundle to another parent folder
• Add Favorite List: Make a list a favorite
• Remove Favorite List: Remove a list from favorites
• Open List: Open a list in Keep It, including by its Link URL or identifier.

Working with Items

• Rename Item: Change the name of an item.
• Change Item Comments: Replace the comments on an item.
• Change Item Source: Replace the Source URL on an item.
• Add Favorite Item: Add an item to the Favorites list.
• Remove Favorite Item: Remove an item from the Favorites list
• Add Tags to Item: Add the specified tags to an item
• Remove Tags from Item: Remove the specified tags from an item
• Change Label on Item: Change the item's label
• Open Item: Open an item, including by its Link URL or identifier.
• Remove Item: Move an item to Deleted Items, or from the specified bundle.

Working with Labels