contacts

v0.1.6

Read and manage Apple Contacts through the macOS Contacts framework.

CodexClaude Code1 Skill

By PedroAVJLicense: MIT0 GitHub starsUpdated last month

Directory evidence

Runtimes: Codex and Claude Code
Parsed components: 1 skill or MCP entry
Source updated: Sep 8, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install contacts for Codex and Claude Code

Installs for the current user

codex plugin marketplace add IchenDEV/agent-plugin-mkt
codex plugin marketplace upgrade agent-plugin-marketplace
codex plugin add contacts@agent-plugin-marketplace

Paste and run these commands in a terminal with Codex. They add and refresh the PluginsMP catalog, then install this plugin.

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/PedroAVJ/contacts

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.

Plugin files

contacts/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
└── skills/apple-contacts/SKILL.md

Included Skills1

apple-contactsskills/apple-contacts/SKILL.md

Read and manage live Apple Contacts on macOS through the bundled Contacts-framework CLI. Use for contact lookup, relationship discovery and exact relationship additions, bounded inventories, account/container disambiguation, exact contact reads, adding verified email addresses, and adding or removing postal addresses without visual automation.

Plugin manifests2

.codex-plugin/plugin.json

{
  "name": "contacts",
  "version": "0.1.6",
  "description": "Read and manage Apple Contacts through the macOS Contacts framework.",
  "author": {
    "name": "PedroAVJ",
    "url": "https://github.com/PedroAVJ"
  },
  "homepage": "https://github.com/PedroAVJ/contacts",
  "repository": "https://github.com/PedroAVJ/contacts",
  "license": "MIT",
  "keywords": [
    "apple-contacts",
    "contacts",
    "macos",
    "address-book"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "Contacts",
    "shortDescription": "Direct Apple Contacts management",
    "longDescription": "Use Apple's Contacts framework directly rather than visual automation: inventory and search raw cards, read structured contact details, discover or add exact directional relationships, add verified email addresses, and add or remove postal addresses with read-back verification.",
    "developerName": "PedroAVJ",
    "category": "Communication",
    "capabilities": [
      "Interactive",
      "Read",
      "Write"
    ],
    "brandColor": "#8E8E93",
    "composerIcon": "./assets/contacts-icon.svg",
    "logo": "./assets/contacts-icon.svg",
    "screenshots": [],
    "defaultPrompt": [
      "Show the relationships stored on My Card",
      "Add this exact relationship to My Card",
      "Find this person in Apple Contacts",
      "Add this verified email address to the exact contact card",
      "Add this address to the exact contact card",
      "Show the contact cards stored in iCloud"
    ]
  }
}

.claude-plugin/plugin.json

{
  "name": "contacts",
  "version": "0.1.6",
  "description": "Read and manage Apple Contacts through the macOS Contacts framework.",
  "author": {
    "name": "PedroAVJ",
    "url": "https://github.com/PedroAVJ"
  },
  "homepage": "https://github.com/PedroAVJ/contacts",
  "repository": "https://github.com/PedroAVJ/contacts",
  "license": "MIT",
  "keywords": [
    "apple-contacts",
    "contacts",
    "macos",
    "address-book"
  ],
  "skills": "./skills/"
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[contacts on Agent Plugins Marketplace](https://pluginsmp.com/plugins/contacts)