Plugsight

Contacts · Cursor & VS Code

Connect iCloud Contacts to Cursor & VS Code

Let your AI look up anyone in your iPhone contacts: emails, phone numbers and companies. Plugsight links iCloud Contacts to Cursor & VS Code in a few minutes, with no code and no exports.

What you can ask Cursor & VS Code about iCloud Contacts

What's the mobile number for Priya at Northwind?
Who do I know at Acme?
Find the email address of my accountant and draft them a note about this year's receipts.

How to connect iCloud Contacts to Cursor & VS Code

  1. Create a free Plugsight account.
  2. Enter your Apple ID and an app-specific password. Plugsight reads every address book on your iCloud account.

Then add Plugsight to Cursor & VS Code

  1. In Plugsight, open MCP servers, create one and copy its URL. For VS Code and Gemini CLI, also create an API key on the server's page.
  2. Cursor: add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project), save, then sign in to Plugsight and click Allow access when the browser opens:{"mcpServers": {"plugsight": {"url": "https://app.plugsight.app/mcp/YOUR_SERVER_ID"}}}
  3. If no browser window opens in Cursor, add an API key instead: put it in an environment variable called PLUGSIGHT_API_KEY and add "headers": {"Authorization": "Bearer ${env:PLUGSIGHT_API_KEY}"} next to the url.
  4. VS Code (Copilot agent mode): add this to .vscode/mcp.json. VS Code asks for the key once and stores it securely:{"inputs": [{"type": "promptString", "id": "plugsight-key", "description": "Plugsight API key", "password": true}], "servers": {"plugsight": {"type": "http", "url": "https://app.plugsight.app/mcp/YOUR_SERVER_ID", "headers": {"Authorization": "Bearer ${input:plugsight-key}"}}}}
  5. Gemini CLI: add this to ~/.gemini/settings.json{"mcpServers": {"plugsight": {"httpUrl": "https://app.plugsight.app/mcp/YOUR_SERVER_ID", "headers": {"Authorization": "Bearer YOUR_API_KEY"}}}}
  6. Reload the tool and ask its agent to use the Plugsight tools.

Cursor signs in to Plugsight in your browser. VS Code, Gemini CLI and other clients connect with your MCP server's URL and an API key. Works with any client that supports remote MCP servers over HTTP.

Full steps and troubleshooting in the docs: Cursor, VS Code, Other MCP apps.

iCloud Contacts data available

  • Search by name, email, phone or company
  • Emails, phones, organisation, addresses, notes, birthdays and links
  • Every iCloud address book

Why use iCloud Contacts in Cursor & VS Code

  • Use business data inside your editor
  • Build dashboards and scripts on real numbers
  • One server for many tools

Questions about iCloud Contacts and Cursor & VS Code

How do I connect iCloud Contacts to Cursor & VS Code?

Create a free Plugsight account and connect iCloud Contacts: Enter your Apple ID and an app-specific password. Plugsight reads every address book on your iCloud account. Then add Plugsight to Cursor & VS Code: In Plugsight, open MCP servers, create one and copy its URL. For VS Code and Gemini CLI, also create an API key on the server's page. Cursor: add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project), save, then sign in to Plugsight and click Allow access when the browser opens: {"mcpServers": {"plugsight": {"url": "https://app.plugsight.app/mcp/YOUR_SERVER_ID"}}} If no browser window opens in Cursor, add an API key instead: put it in an environment variable called PLUGSIGHT_API_KEY and add "headers": {"Authorization": "Bearer ${env:PLUGSIGHT_API_KEY}"} next to the url. VS Code (Copilot agent mode): add this to .vscode/mcp.json. VS Code asks for the key once and stores it securely: {"inputs": [{"type": "promptString", "id": "plugsight-key", "description": "Plugsight API key", "password": true}], "servers": {"plugsight": {"type": "http", "url": "https://app.plugsight.app/mcp/YOUR_SERVER_ID", "headers": {"Authorization": "Bearer ${input:plugsight-key}"}}}} Gemini CLI: add this to ~/.gemini/settings.json {"mcpServers": {"plugsight": {"httpUrl": "https://app.plugsight.app/mcp/YOUR_SERVER_ID", "headers": {"Authorization": "Bearer YOUR_API_KEY"}}}} Reload the tool and ask its agent to use the Plugsight tools.

Can Cursor & VS Code read my iCloud Contacts data?

Yes, once connected. Cursor & VS Code can see: Search by name, email, phone or company; Emails, phones, organisation, addresses, notes, birthdays and links; Every iCloud address book. For example, ask: "What's the mobile number for Priya at Northwind?"

Which Cursor, VS Code & other MCP clients plans work?

Works with any client that supports remote MCP servers over HTTP.

How does Cursor & VS Code sign in to Plugsight?

Cursor signs in to Plugsight in your browser. VS Code, Gemini CLI and other clients connect with your MCP server's URL and an API key.

Can Cursor & VS Code change anything in iCloud Contacts?

No. Plugsight only reads iCloud Contacts; it never creates, changes or deletes anything there.

Is the iCloud Contacts connector free?

Yes. iCloud Contacts works on the Free plan, which includes 2 connections and 1 MCP server, with no credit card. Pro adds more connections and the marketing sources.

Good to know

  • Read-only: Plugsight never adds, changes or deletes contacts.
  • Apple has no official AI connector for iCloud Contacts.

Connect iCloud Contacts to Cursor & VS Code

Free plan, no credit card. Set up in about five minutes.

Updated