{"_id":"@americosmjr/whatsapp-cli","_rev":"2-bb07fd72eb7b138f506b971ee3d9b2e2","name":"@americosmjr/whatsapp-cli","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@americosmjr/whatsapp-cli","version":"1.0.0","keywords":["whatsapp","cli","macos","sqlite","mcp"],"author":{"name":"Americo"},"license":"ISC","_id":"@americosmjr/whatsapp-cli@1.0.0","maintainers":[{"name":"americosmjr","email":"contacto@americojunior.com"}],"bin":{"whatsapp-cli":"bin/whatsapp-cli"},"dist":{"shasum":"eece871a36d6efdf8197d3a8526a5bab86faf77f","tarball":"https://registry.npmjs.org/@americosmjr/whatsapp-cli/-/whatsapp-cli-1.0.0.tgz","fileCount":71,"integrity":"sha512-VEVRGmldAr5G+R3NnbXCnCcMZXvLBY5wEEZrzKrzYj1oI+QPOkGmEeJ/zd46Ou7bzVrqlczrhjQXFyWdKZFlQA==","signatures":[{"sig":"MEYCIQD9jjNJsm2W476bDbBnz+LlAT2OXW/b2OuglIUzjvbr5AIhANj7l2sE6AtnAkaJHHXzyjOTp3SajG/HYXeiQ/DcmGXH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":96435},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"2ce847eddf64818ea554d72a0456b1b4d29f1d32","scripts":{"dev":"tsx src/index.ts","mcp":"npm run build && node dist/index.js mcp","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"americosmjr","email":"contacto@americojunior.com"},"_npmVersion":"11.7.0","description":"WhatsApp macOS Local Data CLI Tool","directories":{},"_nodeVersion":"25.4.0","dependencies":{"ora":"^9.3.0","chalk":"^5.6.2","commander":"^14.0.3","@clack/prompts":"^1.2.0","better-sqlite3":"^12.8.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^6.0.2","@types/node":"^25.5.2","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/whatsapp-cli_1.0.0_1775572995225_0.5708495201129142","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@americosmjr/whatsapp-cli","version":"1.0.1","description":"WhatsApp macOS Local Data CLI Tool","type":"module","main":"dist/index.js","bin":{"whatsapp-cli":"bin/whatsapp-cli"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","mcp":"npm run build && node dist/index.js mcp","test":"echo \"Error: no test specified\" && exit 1","prepublishOnly":"npm run build"},"keywords":["whatsapp","cli","macos","sqlite","mcp"],"author":{"name":"Americo"},"license":"ISC","dependencies":{"@clack/prompts":"^1.2.0","@modelcontextprotocol/sdk":"^1.29.0","better-sqlite3":"^12.8.0","chalk":"^5.6.2","commander":"^14.0.3","ora":"^9.3.0"},"devDependencies":{"@types/better-sqlite3":"^7.6.13","@types/node":"^25.5.2","tsx":"^4.21.0","typescript":"^6.0.2"},"gitHead":"8923a32675990b41fa1f45f1557853672c18c4a1","types":"./dist/index.d.ts","_id":"@americosmjr/whatsapp-cli@1.0.1","_nodeVersion":"25.4.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-35Fnk0fpeN3fbUtg1H5CFfqlFHZElZR+XCY8FiysBubHzTbrsx7ykkvEgCS5MOh5RwhHvQbjhrM3ftA1Pf0QQA==","shasum":"9db44e319b1f56653146aadaf1e765c71426475e","tarball":"https://registry.npmjs.org/@americosmjr/whatsapp-cli/-/whatsapp-cli-1.0.1.tgz","fileCount":71,"unpackedSize":96435,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC3IlkjsRisUfaPyUN/R1Zxhvz55ULosffWL8ip1RwkFQIhAKloXnaxswL+U4MGHmOKGLxiPlW18uCyz1dWqmOxHczl"}]},"_npmUser":{"name":"americosmjr","email":"contacto@americojunior.com"},"directories":{},"maintainers":[{"name":"americosmjr","email":"contacto@americojunior.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/whatsapp-cli_1.0.1_1775573330364_0.7958512689426034"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-07T14:43:15.139Z","modified":"2026-04-07T14:48:50.611Z","1.0.0":"2026-04-07T14:43:15.394Z","1.0.1":"2026-04-07T14:48:50.499Z"},"author":{"name":"Americo"},"license":"ISC","keywords":["whatsapp","cli","macos","sqlite","mcp"],"description":"WhatsApp macOS Local Data CLI Tool","maintainers":[{"name":"americosmjr","email":"contacto@americojunior.com"}],"readme":"# WhatsApp CLI\n\nA powerful Node.js CLI tool and MCP Server for analyzing and extracting local WhatsApp data on macOS.\n\n## Configuration\n\nThis tool works with the local data stored by the WhatsApp for macOS Desktop app.\n\n### Prerequisites\n\n- Node.js (v18 or higher)\n- **Full Disk Access**: You must grant **Full Disk Access** to your terminal (Terminal.app, iTerm2, etc.) in *System Settings > Privacy & Security > Full Disk Access*.\n\n---\n\n## Usage\n\n### 🎮 Interactive Mode (Recommended)\nStart a rich TUI experience to navigate through your chats, contacts, and calls:\n```bash\nnpx whatsapp-cli explore\n```\n\n### 🤖 MCP Server (for AI Tools)\nIntegrate your WhatsApp data directly with AI models like Claude.\n\n**Configuration for Claude Desktop:**\nAdd this to your `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"whatsapp\": {\n      \"command\": \"node\",\n      \"args\": [\"/ABSOLUTE/PATH/TO/whatsapp-cli/dist/index.js\", \"mcp\"]\n    }\n  }\n}\n```\n\n### ⌨️ CLI Commands\n- `explore`: Start the interactive TUI.\n- `check`: Verify database local paths and permissions.\n- `chats`: List recent chat sessions.\n- `messages <jid>`: Show messages from a specific contact/group.\n- `contacts`: List contacts from address book.\n- `calls`: Recent call history.\n- `info`: General overview and statistics.\n\n---\n\n## Development\n\n1. **Install dependencies**:\n   ```bash\n   npm install\n   ```\n\n2. **Run in development**:\n   ```bash\n   npm run dev -- explore\n   ```\n\n3. **Run MCP Server (Dev)**:\n   ```bash\n   npm run mcp\n   ```\n\n4. **Build**:\n   ```bash\n   npm run build\n   ```\n\n## Technical Reference\n\nSee [docs/WHATSAPP.md](docs/WHATSAPP.md) for detailed database schema and storage architecture details.\n","readmeFilename":"README.md"}