Leina 
Wanta 
Inspect a User Record
Read a selected user’s returned account details.
/oo Clerk: Read Clerk user [user ID]. Summarize the returned account fields and metadata for my review.
Connect Clerk to Your AI Agent
Choose a user or filter to review account records, then request a specific metadata change when needed.
11 tools API key
Try a Clerk Task
Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.
oo Skill Clerk
Merge Private User Metadata
Merge a supplied JSON object into the selected user’s private metadata.
/oo Clerk: Deep merge private metadata [JSON object] into Clerk user [user ID] and report the returned metadata.
Start Working with Clerk
-
Install OOMOL
Set up oo CLI and the oo Skill in your agent.
Install OOMOL → -
Connect Clerk
Connect a Clerk Secret Key.
Connect Clerk → -
Give Your Agent a Task
Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →
Choose Your Agent
- The key for the intended Clerk environment and access to the user records.
- Use the user ID for changes. Public, private, and unsafe metadata are separate fields with different visibility.
Clerk Tools
This connection reads and manages Clerk users, merges their metadata, and supports account bans and locks.
User Records
List, count, and inspect users or perform explicitly requested user changes.
User Access State
Ban, unban, lock, or unlock specified users.
11 tools
List Users
List Clerk users with optional filtering and pagination.
clerk.list_users Count Users
Count Clerk users with optional filters.
clerk.count_users Get User
Retrieve a Clerk user by ID.
clerk.get_user Create User
Create a Clerk user.
clerk.create_user Update User
Update a Clerk user.
clerk.update_user Update User Metadata
Deep merge metadata for a Clerk user.
clerk.update_user_metadata Delete User
Delete a Clerk user.
clerk.delete_user Ban User
Ban a Clerk user.
clerk.ban_user Unban User
Unban a Clerk user.
clerk.unban_user Lock User
Lock a Clerk user.
clerk.lock_user Unlock User
Unlock a Clerk user.
clerk.unlock_user No matching tools.
Frequently Asked Questions
Does the metadata operation replace all metadata?
It deep merges the supplied metadata into the selected user record. Choose the metadata field and keys intentionally.
How do I find a user ID?
List users with the relevant filters, then inspect the matching record before applying a change.
How do I avoid changing the wrong environment?
Connect the secret key for the intended Clerk environment and verify the selected user record before a write request.