add_list_items
ChatGPTAdd items to a list or detail_list preference. Items already on the list are reported, not added twice.
Overview
OpenPrefs keeps your preferences in one place you control: dietary needs, favorite places, usual orders, budgets, house rules, and lists such as movies you've watched or restaurants to try. Each preference is an exact setting, a toggle, text, number, choice, schedule or list, grouped into spaces such as Food & Dining or Travel. With OpenPrefs connected, ChatGPT can look up your preferences before making a choice for you, save new ones when you tell it about them, and keep your lists up to date. You decide, space by space, whether ChatGPT may read or also change them, and you can require it to ask before reading or changing any space or single preference. Every change ChatGPT makes is recorded with its reason, and you can review and undo it at openprefs.ai. The same preferences work with the other assistants you connect, so you only have to state them once.
Tools
define_preference
ChatGPTCreate a preference so it can be stored and read from now on, without a restart. Use it when the user wants to record something no existing key covers. The key belongs to this user alone and its space is created if needed. Scalar types need a first value; lists start empty. Give it aliases, the other words the user might use for it, such as "films I've seen" for watched movies, since search finds a preference by its name, aliases and description. Define the key again to update it: the type is fixed, and a name, config or aliases omitted keep the current ones. A new config may add choice options or detail_list columns, rename columns or change a number's unit, as long as the current value still fits it.
delete_preference
ChatGPTDelete one of the user's preferences, with its items if it is a list. Only call this when the user asks.
get_preferences
ChatGPTRead the user's preferences by exact key, up to 20 at a time. Find keys with search_preferences first. List preferences report their item_count; read their items with list_items.
list_contains
ChatGPTCheck which of some labels a list or detail_list preference holds, such as whether the user has seen a movie.
list_items
ChatGPTRead the items of a list or detail_list preference in order, one page at a time.
remove_list_items
ChatGPTRemove items from a list or detail_list preference by label.
search_preferences
ChatGPTSearch the user's preferences and list items by words, tolerating typos, such as "films I've seen" or "The Godfather". This is how to find a preference's key before reading or changing it.
set_preferences
ChatGPTStore up to 20 of the user's toggle, text, number, choice or time_rule preferences at once. Only call this when the user has stated the preference clearly. Values are validated against each key's type. Only existing keys can be set; create a new one with define_preference.
update_list_items
ChatGPTChange items of a list or detail_list preference, found by label: rename one with new_label, or set some of a detail_list item's fields, such as its rating or note. Fields left out keep their values; null clears one.
add_list_items
Claudedefine_preference
Claudedelete_preference
Claudeget_preferences
Claudelist_contains
Claudelist_items
Clauderemove_list_items
Claudesearch_preferences
Claudeset_preferences
Claudeupdate_list_items
ClaudeCapabilities
Writes
Example Prompts
Click any prompt to copy it.
