{"_id":"apple-mcp","_rev":"9-cf9fc066aa065cebb32b50da0dd89de2","name":"apple-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"0.2.1":{"name":"apple-mcp","version":"0.2.1","keywords":["mcp","apple","contacts","notes","messages","mail","claude"],"author":{"name":"Dhravya Shah"},"license":"MIT","_id":"apple-mcp@0.2.1","maintainers":[{"name":"dhravya","email":"dhravyashah@gmail.com"}],"homepage":"https://github.com/dhravya/apple-mcp#readme","bugs":{"url":"https://github.com/dhravya/apple-mcp/issues"},"bin":{"apple-mcp":"index.ts"},"dist":{"shasum":"2a1f8a049970f3bce7652039a4eb2beabcf53f9c","tarball":"https://registry.npmjs.org/apple-mcp/-/apple-mcp-0.2.1.tgz","fileCount":14,"integrity":"sha512-JxdO7eU2FY4KDMlCV3Sz+S4oxyAZaZUzi72bD+ZdcRrrVrHguu3tO+7GHmLCYEHhMXMuumiLlFPsaWEoUmfAnQ==","signatures":[{"sig":"MEYCIQCEVWGZqD1QnXGlOXCiSIVoV4QN/T+dCZ8Ubo1CGhO+nQIhAO+eRclvovfZA55mtreWdpZo7aR5nIaVK5LywoKYqFZC","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":132398},"type":"module","module":"index.ts","gitHead":"2b2042e499bfbf2d033e50aecddeac412a5c32a3","scripts":{"dev":"bun run index.ts"},"_npmUser":{"name":"dhravya","email":"dhravyashah@gmail.com"},"repository":{"url":"git+https://github.com/dhravya/apple-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Apple MCP tools for contacts, notes, messages, and mail integration","directories":{},"_nodeVersion":"22.8.0","dependencies":{"zod":"^3.24.2","@jxa/run":"^1.3.6","mcp-proxy":"^2.4.0","@types/express":"^5.0.0","run-applescript":"^7.0.0","@jxa/global-type":"^1.3.6","@hono/node-server":"^1.13.8","@modelcontextprotocol/sdk":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","@types/node":"^22.13.4"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/apple-mcp_0.2.1_1740705272142_0.9753239934939355","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"apple-mcp","version":"0.2.2","keywords":["mcp","apple","contacts","notes","messages","mail","claude"],"author":{"name":"Dhravya Shah"},"license":"MIT","_id":"apple-mcp@0.2.2","maintainers":[{"name":"dhravya","email":"dhravyashah@gmail.com"}],"homepage":"https://github.com/dhravya/apple-mcp#readme","bugs":{"url":"https://github.com/dhravya/apple-mcp/issues"},"bin":{"apple-mcp":"index.ts"},"dist":{"shasum":"93852cfd70ab8e5c92dd38b0ab01be4d1135ed6a","tarball":"https://registry.npmjs.org/apple-mcp/-/apple-mcp-0.2.2.tgz","fileCount":14,"integrity":"sha512-sX0DAfZC7nfVScBVH4jXJYf2LivKJ84uxObvI4y78yW19cy6yOZarqF+MmU7/iZ6dfpRlDe7VksD0nIqW9Uq0Q==","signatures":[{"sig":"MEUCIQDF5pExnq7LVz3HnLw+5tsvLCy5GFZtPZpCMa04HrTDZAIgM/h0CW4OYpBoQzjtgSOKbgCZH3h3DikRWUV8tQFSoYk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":138453},"type":"module","module":"index.ts","gitHead":"64a77d806e33a0005740714f2e80e7577eda9134","scripts":{"dev":"bun run index.ts"},"_npmUser":{"name":"dhravya","email":"dhravyashah@gmail.com"},"repository":{"url":"git+https://github.com/dhravya/apple-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Apple MCP tools for contacts, notes, messages, and mail integration","directories":{},"_nodeVersion":"22.8.0","dependencies":{"zod":"^3.24.2","@jxa/run":"^1.3.6","mcp-proxy":"^2.4.0","@types/express":"^5.0.0","run-applescript":"^7.0.0","@jxa/global-type":"^1.3.6","@hono/node-server":"^1.13.8","@modelcontextprotocol/sdk":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","@types/node":"^22.13.4"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/apple-mcp_0.2.2_1740709964201_0.059233531798496886","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"apple-mcp","version":"0.2.3","keywords":["mcp","apple","contacts","notes","messages","mail","claude"],"author":{"name":"Dhravya Shah"},"license":"MIT","_id":"apple-mcp@0.2.3","maintainers":[{"name":"dhravya","email":"dhravyashah@gmail.com"}],"homepage":"https://github.com/dhravya/apple-mcp#readme","bugs":{"url":"https://github.com/dhravya/apple-mcp/issues"},"bin":{"apple-mcp":"index.ts"},"dist":{"shasum":"b30cdf8ecf97689431447d15d5aab22528195b6f","tarball":"https://registry.npmjs.org/apple-mcp/-/apple-mcp-0.2.3.tgz","fileCount":11,"integrity":"sha512-VKr80bbWfnMLdQFGTl0GNV/CxgBw+itTvYhN17nfAwEkQpLTXLwSQVRe/sckR4j65B8kR1b5eS+AN0Z5w+wdiQ==","signatures":[{"sig":"MEYCIQDDSHu5SKdwH+7nTEGSuDGAsxREI+GtLKQZJyRQyP8T2gIhAORP/XbEeuSznlRN8xFNEeJXcude2s4fem+aUDzH8kBk","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":135381},"type":"module","module":"index.ts","gitHead":"63ddff68a71df4f6168c6869d26fe4c0f4fe6f34","scripts":{"dev":"bun run index.ts"},"_npmUser":{"name":"dhravya","email":"dhravyashah@gmail.com"},"repository":{"url":"git+https://github.com/dhravya/apple-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Apple MCP tools for contacts, notes, messages, and mail integration","directories":{},"_nodeVersion":"22.8.0","dependencies":{"zod":"^3.24.2","@jxa/run":"^1.3.6","mcp-proxy":"^2.4.0","@types/express":"^5.0.0","run-applescript":"^7.0.0","@jxa/global-type":"^1.3.6","@hono/node-server":"^1.13.8","@modelcontextprotocol/sdk":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","@types/node":"^22.13.4"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/apple-mcp_0.2.3_1740881782104_0.7515529869747672","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"apple-mcp","version":"0.2.4","keywords":["mcp","apple","contacts","notes","messages","mail","claude"],"author":{"name":"Dhravya Shah"},"license":"MIT","_id":"apple-mcp@0.2.4","maintainers":[{"name":"dhravya","email":"dhravyashah@gmail.com"}],"homepage":"https://github.com/dhravya/apple-mcp#readme","bugs":{"url":"https://github.com/dhravya/apple-mcp/issues"},"bin":{"apple-mcp":"index.ts"},"dist":{"shasum":"559e4ecbdcf2bb686b5c22f9e3c78decb0eae280","tarball":"https://registry.npmjs.org/apple-mcp/-/apple-mcp-0.2.4.tgz","fileCount":11,"integrity":"sha512-Y29ssP/3nMT68oOx30lpqFXvtwXxa8pduqb88AHSWePqcqwJoUvMSUtDk4XeSrc79hn6054VMZJYV6g1wVRQGA==","signatures":[{"sig":"MEQCIBITA/BPhqKZkFXihq100cbdQ0Tcsex0N5cuJAmPnEH6AiBSBqADUBsvYWlbSHx954RLV2DHEkuz7oyVCHoMm4DbUA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":135381},"type":"module","module":"index.ts","gitHead":"63ddff68a71df4f6168c6869d26fe4c0f4fe6f34","scripts":{"dev":"bun run index.ts"},"_npmUser":{"name":"dhravya","email":"dhravyashah@gmail.com"},"repository":{"url":"git+https://github.com/dhravya/apple-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Apple MCP tools for contacts, notes, messages, and mail integration","directories":{},"_nodeVersion":"22.8.0","dependencies":{"zod":"^3.24.2","@jxa/run":"^1.3.6","mcp-proxy":"^2.4.0","@types/express":"^5.0.0","run-applescript":"^7.0.0","@jxa/global-type":"^1.3.6","@hono/node-server":"^1.13.8","@modelcontextprotocol/sdk":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","@types/node":"^22.13.4"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/apple-mcp_0.2.4_1740882734104_0.0797650124322622","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"apple-mcp","version":"0.3.0","keywords":["mcp","apple","contacts","notes","messages","mail","claude"],"author":{"name":"Dhravya Shah"},"license":"MIT","_id":"apple-mcp@0.3.0","maintainers":[{"name":"dhravya","email":"dhravyashah@gmail.com"}],"homepage":"https://github.com/dhravya/apple-mcp#readme","bugs":{"url":"https://github.com/dhravya/apple-mcp/issues"},"bin":{"apple-mcp":"index.ts"},"dist":{"shasum":"b590c7dfc98dfc2c68582db980062aecb5fc57f9","tarball":"https://registry.npmjs.org/apple-mcp/-/apple-mcp-0.3.0.tgz","fileCount":13,"integrity":"sha512-ef60usxe/V3u/PK8UVXKSfk6ugbncUeyUli5toarHNTx4eHsmI5aesBnKdorY1ymR7hR/QB6h+58QMJ7UvJ7ew==","signatures":[{"sig":"MEQCIGGSHUfCJtmsl8/Sq2BgiZs7gEGTxY7+p9loeqdU7UhZAiBeM03Sg8OOnncYUfXZsPH9jL7ux0fA5V4fCLBDduzM7g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":146076},"type":"module","module":"index.ts","engines":{"bun":">=1.0.0","node":">=18.0.0"},"gitHead":"63ddff68a71df4f6168c6869d26fe4c0f4fe6f34","scripts":{"dev":"bun run index.ts","start":"bun run index.ts"},"_npmUser":{"name":"dhravya","email":"dhravyashah@gmail.com"},"repository":{"url":"git+https://github.com/dhravya/apple-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Apple MCP tools for contacts, notes, messages, and mail integration","directories":{},"_nodeVersion":"22.8.0","dependencies":{"zod":"^3.24.2","@jxa/run":"^1.3.6","mcp-proxy":"^2.4.0","@types/express":"^5.0.0","run-applescript":"^7.0.0","@jxa/global-type":"^1.3.6","@hono/node-server":"^1.13.8","@modelcontextprotocol/sdk":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","@types/node":"^22.13.4"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/apple-mcp_0.3.0_1740886540052_0.5370513461788116","host":"s3://npm-registry-packages-npm-production"}},"0.2.5":{"name":"apple-mcp","version":"0.2.5","keywords":["mcp","apple","contacts","notes","messages","mail","claude"],"author":{"name":"Dhravya Shah"},"license":"MIT","_id":"apple-mcp@0.2.5","maintainers":[{"name":"dhravya","email":"dhravyashah@gmail.com"}],"homepage":"https://github.com/dhravya/apple-mcp#readme","bugs":{"url":"https://github.com/dhravya/apple-mcp/issues"},"bin":{"apple-mcp":"index.ts"},"dist":{"shasum":"5c65d6e3c129a47e92538684c955b15a4a009e9a","tarball":"https://registry.npmjs.org/apple-mcp/-/apple-mcp-0.2.5.tgz","fileCount":13,"integrity":"sha512-6HswKIbuAJ0Bf0vJZ6jvvosxPqvtjmEUL67ONCbqH2oAGYtNWO/0rPGL4pNK2NJuhs3TwREv5GKw3aSGGjON7w==","signatures":[{"sig":"MEUCIFTc+dNfeZjldRgjRvhKHgWbrI1EO+k0qrp595wVFlACAiEA7p9ShMQ2hmLbSdWjpVbUaBUAE+NIGNNFlkI8D+1RNzU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":149421},"type":"module","module":"index.ts","gitHead":"a0677fb14eb1f85fca765f87d848b41920c24f29","scripts":{"dev":"bun run index.ts"},"_npmUser":{"name":"dhravya","email":"dhravyashah@gmail.com"},"repository":{"url":"git+https://github.com/dhravya/apple-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Apple MCP tools for contacts, notes, messages, and mail integration","directories":{},"_nodeVersion":"22.8.0","dependencies":{"zod":"^3.24.2","@jxa/run":"^1.3.6","mcp-proxy":"^2.4.0","@types/express":"^5.0.0","run-applescript":"^7.0.0","@jxa/global-type":"^1.3.6","@hono/node-server":"^1.13.8","@modelcontextprotocol/sdk":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","@types/node":"^22.13.4"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/apple-mcp_0.2.5_1741131630060_0.9761855999660394","host":"s3://npm-registry-packages-npm-production"}},"0.2.6":{"name":"apple-mcp","version":"0.2.6","keywords":["mcp","apple","contacts","notes","messages","mail","claude"],"author":{"name":"Dhravya Shah"},"license":"MIT","_id":"apple-mcp@0.2.6","maintainers":[{"name":"dhravya","email":"dhravyashah@gmail.com"}],"homepage":"https://github.com/dhravya/apple-mcp#readme","bugs":{"url":"https://github.com/dhravya/apple-mcp/issues"},"bin":{"apple-mcp":"index.ts"},"dist":{"shasum":"2863f5e89b6a6fd4a2f8683dc489d032903f0852","tarball":"https://registry.npmjs.org/apple-mcp/-/apple-mcp-0.2.6.tgz","fileCount":15,"integrity":"sha512-VIiLP0y8DcsPf3GHjngkJTzw5v6hognybVEEVqtA4+HTE9huYdVM+E/Q24dvmyHNyuvrubxxflB86O+dUjsaMQ==","signatures":[{"sig":"MEUCIQDEbfI55fjXXM1P4S0OPYuvMdUMGo6DxyJ5jZoOJVb5ZgIgaPY+D+GNSm43z+g4nqNKIhkm49mZoAZ6pW7UGhCorg4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":178708},"type":"module","module":"index.ts","gitHead":"561f3f5e689e68663241da37cc91aaf0185e2b2b","scripts":{"dev":"bun run index.ts"},"_npmUser":{"name":"dhravya","email":"dhravyashah@gmail.com"},"repository":{"url":"git+https://github.com/dhravya/apple-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Apple MCP tools for contacts, notes, messages, and mail integration","directories":{},"_nodeVersion":"22.8.0","dependencies":{"zod":"^3.24.2","@jxa/run":"^1.3.6","mcp-proxy":"^2.4.0","@types/express":"^5.0.0","run-applescript":"^7.0.0","@jxa/global-type":"^1.3.6","@hono/node-server":"^1.13.8","@modelcontextprotocol/sdk":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","@types/node":"^22.13.4"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/apple-mcp_0.2.6_1742798984732_0.10674797600203556","host":"s3://npm-registry-packages-npm-production"}},"0.2.7":{"name":"apple-mcp","version":"0.2.7","keywords":["mcp","apple","contacts","notes","messages","mail","claude"],"author":{"name":"Dhravya Shah"},"license":"MIT","_id":"apple-mcp@0.2.7","maintainers":[{"name":"dhravya","email":"dhravyashah@gmail.com"}],"homepage":"https://github.com/dhravya/apple-mcp#readme","bugs":{"url":"https://github.com/dhravya/apple-mcp/issues"},"bin":{"apple-mcp":"index.ts"},"dist":{"shasum":"eea238960d52c63b54048e604283c50929039ca6","tarball":"https://registry.npmjs.org/apple-mcp/-/apple-mcp-0.2.7.tgz","fileCount":17,"integrity":"sha512-oerI5qzSJSljWvEkrwAhfKzHzKEAY3NDwdsh1nV8lnRwqtIeC/aCIXIeppb3b5Z+z3BicTmbUMUY0Qw8amSF1w==","signatures":[{"sig":"MEUCIA9V6L8p2f4V5xKylCrBHOWkcTESF5S2gaamzi3zBpoNAiEAqA/uZLKjxrsOpFvphTj3p7ruslFC0QMuzpalWgJaC5Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":217016},"type":"module","module":"index.ts","gitHead":"8e42f049531969fbe8a38d7c1826f40d03f93462","scripts":{"dev":"bun run index.ts"},"_npmUser":{"name":"dhravya","email":"dhravyashah@gmail.com"},"repository":{"url":"git+https://github.com/dhravya/apple-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Apple MCP tools for contacts, notes, messages, and mail integration","directories":{},"_nodeVersion":"22.8.0","dependencies":{"zod":"^3.24.2","@jxa/run":"^1.3.6","mcp-proxy":"^2.4.0","@types/express":"^5.0.0","run-applescript":"^7.0.0","@jxa/global-type":"^1.3.6","@hono/node-server":"^1.13.8","@modelcontextprotocol/sdk":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","@types/node":"^22.13.4"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/apple-mcp_0.2.7_1743633228450_0.0014061204356630164","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"apple-mcp","version":"1.0.0","module":"index.ts","type":"module","description":"Apple MCP tools for contacts, notes, messages, and mail integration","author":{"name":"Dhravya Shah"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/dhravya/apple-mcp.git"},"keywords":["mcp","apple","contacts","notes","messages","mail","claude"],"bin":{"apple-mcp":"dist/index.js"},"scripts":{"dev":"bun run index.ts","build":"bun build index.ts --outfile=dist/index.js --target=node --minify","start":"node dist/index.js","prepublishOnly":"bun run build","test":"bun run test-runner.ts all","test:watch":"bun test tests/**/*.test.ts --preload ./tests/setup.ts --watch","test:contacts":"bun run test-runner.ts contacts","test:contacts-full":"bun test tests/integration/contacts.test.ts --preload ./tests/setup.ts","test:messages":"bun test tests/integration/messages.test.ts --preload ./tests/setup.ts","test:notes":"bun test tests/integration/notes.test.ts --preload ./tests/setup.ts","test:mail":"bun test tests/integration/mail.test.ts --preload ./tests/setup.ts","test:reminders":"bun test tests/integration/reminders.test.ts --preload ./tests/setup.ts","test:calendar":"bun test tests/integration/calendar.test.ts --preload ./tests/setup.ts","test:maps":"bun test tests/integration/maps.test.ts --preload ./tests/setup.ts","test:web-search":"bun test tests/integration/web-search.test.ts --preload ./tests/setup.ts","test:mcp":"bun test tests/mcp/handlers.test.ts --preload ./tests/setup.ts"},"devDependencies":{"@types/bun":"latest","@types/node":"^22.13.4"},"peerDependencies":{"typescript":"^5.0.0"},"dependencies":{"@hono/node-server":"^1.13.8","@jxa/global-type":"^1.3.6","@jxa/run":"^1.3.6","@modelcontextprotocol/sdk":"^1.5.0","@types/express":"^5.0.0","mcp-proxy":"^2.4.0","run-applescript":"^7.0.0","zod":"^3.24.2"},"_id":"apple-mcp@1.0.0","gitHead":"d1d150876c65923400d718b0b66b779515855783","bugs":{"url":"https://github.com/dhravya/apple-mcp/issues"},"homepage":"https://github.com/dhravya/apple-mcp#readme","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-4jLk/6n1g8PZ3jOlCJfj+xD09Uddm1D4OQina1tbRVeXwRk6H9oj+P+sBdCFNBxPzmKujT6Ioq4C/TZnqPdedQ==","shasum":"7203e3ffad4cecea990d296f9b8ae7cf20520264","tarball":"https://registry.npmjs.org/apple-mcp/-/apple-mcp-1.0.0.tgz","fileCount":34,"unpackedSize":27732988,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCnShPCy3+FqGuphlx9FoxirjqAm00bVZjrmw1/x/BJUwIgQd0nETiVAm7pgi37PTBk1lR57I6KWq9jp4SXh8SZ9Qg="}]},"_npmUser":{"name":"dhravya","email":"dhravyashah@gmail.com"},"directories":{},"maintainers":[{"name":"dhravya","email":"dhravyashah@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/apple-mcp_1.0.0_1754870741653_0.33162608077423883"},"_hasShrinkwrap":false}},"time":{"created":"2025-02-28T01:14:32.051Z","modified":"2025-08-11T00:05:42.370Z","0.2.1":"2025-02-28T01:14:32.378Z","0.2.2":"2025-02-28T02:32:44.458Z","0.2.3":"2025-03-02T02:16:22.350Z","0.2.4":"2025-03-02T02:32:14.291Z","0.3.0":"2025-03-02T03:35:40.419Z","0.2.5":"2025-03-04T23:40:30.254Z","0.2.6":"2025-03-24T06:49:44.924Z","0.2.7":"2025-04-02T22:33:48.664Z","1.0.0":"2025-08-11T00:05:42.193Z"},"bugs":{"url":"https://github.com/dhravya/apple-mcp/issues"},"author":{"name":"Dhravya Shah"},"license":"MIT","homepage":"https://github.com/dhravya/apple-mcp#readme","keywords":["mcp","apple","contacts","notes","messages","mail","claude"],"repository":{"type":"git","url":"git+https://github.com/dhravya/apple-mcp.git"},"description":"Apple MCP tools for contacts, notes, messages, and mail integration","maintainers":[{"name":"dhravya","email":"dhravyashah@gmail.com"}],"readme":"# 🍎 Apple MCP - Your Mac's Best Friend\n\n> **Plot twist:** Your Mac can do more than just look pretty. Turn your Apple apps into AI superpowers!\n\nLove this MCP? Check out supermemory MCP too - https://mcp.supermemory.ai\n\n[![smithery badge](https://smithery.ai/badge/@Dhravya/apple-mcp)](https://smithery.ai/server/@Dhravya/apple-mcp)\n\n<a href=\"https://glama.ai/mcp/servers/gq2qg6kxtu\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/gq2qg6kxtu/badge\" alt=\"Apple Server MCP server\" />\n</a>\n\n## 🤯 What Can This Thing Do?\n\n**Basically everything you wish your Mac could do automatically (but never bothered to set up):**\n\n### 💬 **Messages** - Because who has time to text manually?\n\n- Send messages to anyone in your contacts (even that person you've been avoiding)\n- Read your messages (finally catch up on those group chats)\n- Schedule messages for later (be that organized person you pretend to be)\n\n### 📝 **Notes** - Your brain's external hard drive\n\n- Create notes faster than you can forget why you needed them\n- Search through that digital mess you call \"organized notes\"\n- Actually find that brilliant idea you wrote down 3 months ago\n\n### 👥 **Contacts** - Your personal network, digitized\n\n- Find anyone in your contacts without scrolling forever\n- Get phone numbers instantly (no more \"hey, what's your number again?\")\n- Actually use that contact database you've been building for years\n\n### 📧 **Mail** - Email like a pro (or at least pretend to)\n\n- Send emails with attachments, CC, BCC - the whole professional shebang\n- Search through your email chaos with surgical precision\n- Schedule emails for later (because 3 AM ideas shouldn't be sent at 3 AM)\n- Check unread counts (prepare for existential dread)\n\n### ⏰ **Reminders** - For humans with human memory\n\n- Create reminders with due dates (finally remember to do things)\n- Search through your reminder graveyard\n- List everything you've been putting off\n- Open specific reminders (face your procrastination)\n\n### 📅 **Calendar** - Time management for the chronically late\n\n- Create events faster than you can double-book yourself\n- Search for that meeting you're definitely forgetting about\n- List upcoming events (spoiler: you're probably late to something)\n- Open calendar events directly (skip the app hunting)\n\n### 🗺️ **Maps** - For people who still get lost with GPS\n\n- Search locations (find that coffee shop with the weird name)\n- Save favorites (bookmark your life's important spots)\n- Get directions (finally stop asking Siri while driving)\n- Create guides (be that friend who plans everything)\n- Drop pins like you're claiming territory\n\n## 🎭 The Magic of Chaining Commands\n\nHere's where it gets spicy. You can literally say:\n\n_\"Read my conference notes, find contacts for the people I met, and send them a thank you message\"_\n\nAnd it just... **works**. Like actual magic, but with more code.\n\n## 🚀 Installation (The Easy Way)\n\n### Option 1: Smithery (For the Sophisticated)\n\n```bash\nnpx -y install-mcp apple-mcp --client claude\n```\n\nFor Cursor users (we see you):\n\n```bash\nnpx -y install-mcp apple-mcp --client cursor\n```\n\n### Option 2: Manual Setup (For the Brave)\n\n<details>\n<summary>Click if you're feeling adventurous</summary>\n\nFirst, get bun (if you don't have it already):\n\n```bash\nbrew install oven-sh/bun/bun\n```\n\nThen add this to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"apple-mcp\": {\n      \"command\": \"bunx\",\n      \"args\": [\"--no-cache\", \"apple-mcp@latest\"]\n    }\n  }\n}\n```\n\n</details>\n\n## 🎬 See It In Action\n\nHere's a step-by-step video walkthrough: https://x.com/DhravyaShah/status/1892694077679763671\n\n(Yes, it's actually as cool as it sounds)\n\n## 🎯 Example Commands That'll Blow Your Mind\n\n```\n\"Send a message to mom saying I'll be late for dinner\"\n```\n\n```\n\"Find all my AI research notes and email them to sarah@company.com\"\n```\n\n```\n\"Create a reminder to call the dentist tomorrow at 2pm\"\n```\n\n```\n\"Show me my calendar for next week and create an event for coffee with Alex on Friday\"\n```\n\n```\n\"Find the nearest pizza place and save it to my favorites\"\n```\n\n## 🛠️ Local Development (For the Tinkerers)\n\n```bash\ngit clone https://github.com/dhravya/apple-mcp.git\ncd apple-mcp\nbun install\nbun run index.ts\n```\n\nNow go forth and automate your digital life! 🚀\n\n---\n\n_Made with ❤️ by supermemory (and honestly, claude code)_\n","readmeFilename":"README.md"}