imaplisted
Install: claude install-skill afkbot-io/afkbotio
# imap
Use this skill for mailbox search via unified tool `app.run`.
Tool methods:
- `app.run`
- `credentials.list`
- `credentials.request`
Supported actions (`app_name=imap`):
- `search_messages`
Credential set (per `profile_name`):
- required: `imap_host`, `imap_port`, `imap_username`, `imap_password`
- optional: `imap_use_ssl` (default `true`)
Runtime params for `app.run`:
- `app_name=imap`
- `action=search_messages`
- `profile_name=<credential profile>` (optional; runtime auto-picks default or the only available profile)
- `params={query?, mailbox?, limit?}`
- use top-level key `params`
Action payload contract:
- `search_messages`
- required: none
- optional: `query`, `mailbox`, `limit`, `host_credential_name`, `port_credential_name`, `username_credential_name`, `password_credential_name`, `use_ssl_credential_name`
Preferred example:
```json
{
"app_name": "imap",
"action": "search_messages",
"profile_name": "default",
"params": {
"query": "UNSEEN",
"mailbox": "INBOX",
"limit": 10
}
}
```
Workflow:
1. Resolve credential profile:
- explicit user choice -> use it;
- otherwise let runtime auto-pick a single/default profile;
- if multiple active profiles exist without one default, use `credentials.list` and ask user to choose.
2. Verify required IMAP credentials in selected profile.
3. For missing values, call `credentials.request` without `value` and let runtime switch to secure input.
4. Execute `app.run` action `search_messages`.
5