@purplesquirrel/apple-utilities-mcp
v0.1.0
Published
MCP server for Apple utilities — Weather, Stocks, Voice Memos, Screen Time, Passwords, Freeform via AppleScript and shell commands
Readme
Apple Utilities MCP
MCP server for Apple utilities — Weather, Stocks, Voice Memos, Screen Time, Passwords, and Freeform via AppleScript and shell commands.
Install
npm install
npm run buildUsage
npm startTools (10)
| Tool | Description |
|------|-------------|
| weather_current | Get current weather for a location via wttr.in |
| weather_forecast | Get 3-day forecast for a location |
| stocks_quote | Get current price for a ticker symbol via Yahoo Finance |
| stocks_watchlist | Get all stocks in the macOS Stocks app watchlist |
| voice_memo_list | List voice memos with title, date, and duration |
| voice_memo_record | Start or stop recording a voice memo |
| screen_time_today | Get today's Screen Time stats and per-app breakdown |
| passwords_search | Search saved passwords by site/service name (metadata only) |
| freeform_create | Create a new Freeform board |
| freeform_add_text | Add text to a Freeform board |
Permissions
Some tools require macOS permissions:
- Voice Memos: Accessibility access for UI scripting
- Screen Time: Full Disk Access for reading the knowledge store database
- Passwords: Keychain access (will prompt for authorization)
- Freeform: Accessibility access for UI scripting
MCP Config
Add to ~/.mcp.json:
{
"apple-utilities": {
"command": "node",
"args": ["/Volumes/Virtual Server/projects/apple-utilities-mcp/dist/index.js"]
}
}