apple-contacts
Look up contacts from macOS Contacts.app. Use when resolving phone numbers to names, finding contact info, or searching the address book.
Informações da origem
- Repositório
- ThinkfleetAI/thinkfleet-engine
- Última atividade na origem
- 1 de fevereiro de 2026 às 16:21
- Idioma detectado do SKILL.md
- inglês
- Estrelas
- 0
- Forks
- 0
Opções de instalação
Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.
Revise os arquivos de origem
Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.
Exibindo SKILL.md
SKILL.md
Instruções da origem · Visualização somente leitura- name
- apple-contacts
- description
- Look up contacts from macOS Contacts.app. Use when resolving phone numbers to names, finding contact info, or searching the address book.
- metadata
- {"thinkfleetbot":{"emoji":"👤","os":["darwin"]}}
# Apple Contacts
Query Contacts.app via AppleScript.
## Quick Lookups
```bash
# By phone (name only)
osascript -e 'tell application "Contacts" to get name of every person whose value of phones contains "+1XXXXXXXXXX"'
# By name
osascript -e 'tell application "Contacts" to get name of every person whose name contains "John"'
# List all
osascript -e 'tell application "Contacts" to get name of every person'
```
## Full Contact Info
⚠️ Don't use `first person whose` — buggy. Use this pattern:
```bash
# By phone
osascript -e 'tell application "Contacts"
set matches to every person whose value of phones contains "+1XXXXXXXXXX"
if length of matches > 0 then
set p to item 1 of matches
return {name of p, value of phones of p, value of emails of p}
end if
end tell'
# By name
osascript -e 'tell application "Contacts"
set matches to every person whose name contains "John"
if length of matches > 0 then
set p to item 1 of matches
return {name of p, value of phones of p, value of emails of p}
end if
end tell'
```
## Phone Lookup
⚠️ **Exact string match required** — must match stored format exactly.
| Stored | Search | Works? |
|--------|--------|--------|
| `+1XXXXXXXXXX` | `+1XXXXXXXXXX` | ✅ |
| `+1XXXXXXXXXX` | `XXXXXXXXXX` | ❌ |
Try with `+1` prefix first. If fails, search by name instead.
## Name Search
- Case-insensitive
- Partial match with `contains`
- Exact match: use `is` instead of `contains`
## Output
Returns comma-separated: `name, phone1, [phone2...], email1, [email2...]`
No match = empty output (not an error).
Ver no GitHub