omerfarooq223/personal-ai-employee
Personal AI Employee — autonomous Gmail monitoring, reasoning loop, HITL approval, and LinkedIn posting
Platform-specific configuration:
{
"mcpServers": {
"personal-ai-employee": {
"command": "npx",
"args": [
"-y",
"personal-ai-employee"
]
}
}
}Add the config above to .claude/settings.json under the mcpServers key.
Author: Muhammad Umar Farooq GitHub: omerfarooq223 Tier: Silver Stack: Claude Code + Obsidian + Python + Node.js + Gmail API + Groq LLaMA 3.3 70B
---
A fully autonomous Personal AI Employee that monitors your Gmail, reasons about incoming tasks, waits for your approval, and takes real-world actions — all while you stay in control.
> "Your life and business on autopilot. Local-first, agent-driven, human-in-the-loop."
---
Gmail → gmail_watcher.py → Needs_Action/
↓
reasoning_loop.py → Plans/ + Pending_Approval/
↓
[YOU approve by moving file]
↓
approval_watcher.py → Groq AI → Gmail MCP → Real Email Sent → Done/
↓
LinkedIn Poster → Live LinkedIn Post---
| Feature | Implementation | |---|---| | Gmail Watcher | Polls every 2 min, creates .md files in Needs_Action/ | | Approval Watcher | Watches Approved/, executes actions automatically | | Claude Reasoning Loop | Analyzes emails, creates structured Plan.md files | | Gmail Send MCP Server | Node.js MCP server, sends real emails via Gmail API | | AI-Generated Replies | Uses Groq LLaMA 3.3 70B to write contextual email replies | | HITL Approval Workflow | Human moves file to Approved/ to trigger execution | | LinkedIn Auto-Poster | Auto-posts via Playwright browser automation | | Cron Scheduling | launchd plists run watchers on startup and every 2 min | | Agent Skills | 4 SKILL.md files documenting all agent capabilities |
---
personal-ai-employee/
│
├── CLoading reviews...