{"id":32517765,"url":"https://github.com/kjenney/personal-assistant-plugin","last_synced_at":"2026-07-13T11:31:08.127Z","repository":{"id":320621127,"uuid":"1082736703","full_name":"kjenney/personal-assistant-plugin","owner":"kjenney","description":"A Claude Code plugin that turns Claude Code into your personal assistant","archived":false,"fork":false,"pushed_at":"2025-10-24T19:59:00.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-24T21:24:34.714Z","etag":null,"topics":["claude-code"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kjenney.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-24T17:31:15.000Z","updated_at":"2025-10-24T19:59:04.000Z","dependencies_parsed_at":"2025-10-24T21:24:36.614Z","dependency_job_id":null,"html_url":"https://github.com/kjenney/personal-assistant-plugin","commit_stats":null,"previous_names":["kjenney/personal-assistant-plugin"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/kjenney/personal-assistant-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjenney%2Fpersonal-assistant-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjenney%2Fpersonal-assistant-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjenney%2Fpersonal-assistant-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjenney%2Fpersonal-assistant-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kjenney","download_url":"https://codeload.github.com/kjenney/personal-assistant-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjenney%2Fpersonal-assistant-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35421716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-13T02:00:06.543Z","response_time":119,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code"],"created_at":"2025-10-28T03:00:49.631Z","updated_at":"2026-07-13T11:31:08.122Z","avatar_url":"https://github.com/kjenney.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Personal Assistant Plugin for Claude Code\n\nTransform Claude Code into your intelligent personal assistant with seamless Gmail and Google Calendar integration. This plugin helps you manage emails, coordinate meetings, and stay organized throughout your day.\n\n## Features\n\n### Email Management\n- **Smart Email Summaries**: Get prioritized summaries of your inbox\n- **Context-Aware Responses**: Draft responses based on email thread context\n- **Advanced Search**: Find emails using natural language queries\n- **Priority Detection**: Automatically identifies urgent and important messages\n\n### Calendar Management\n- **Schedule Overview**: View your daily, weekly schedule at a glance\n- **Smart Scheduling**: Find optimal time slots for meetings and focus work\n- **Meeting Preparation**: Get context and prep materials for upcoming meetings\n- **Conflict Detection**: Automatically identifies scheduling conflicts\n\n### Personal Assistant Commands\n\n#### `/morning-brief`\nStart your day right with a comprehensive morning briefing:\n- Today's calendar events and schedule\n- Important email summaries\n- Action items requiring attention\n- Recommendations for optimal time management\n\n#### `/schedule [action] [details]`\nManage your calendar effortlessly:\n- View schedules by day, week, or date range\n- Create new events with natural language\n- Update or delete existing events\n- Check for conflicts\n\n#### `/email-summary [timeframe] [filter]`\nTriage your inbox intelligently:\n- Prioritized email summaries (HIGH/MEDIUM/LOW)\n- Filter by sender, subject, or keywords\n- Actionable recommendations\n- Suggested response approaches\n\n#### `/meeting-prep [meeting]`\nNever go into a meeting unprepared:\n- Meeting details and attendees\n- Relevant email context\n- Recent communication history\n- Talking points and recommendations\n\n#### `/free-time [duration] [timeframe] [preferences]`\nFind the perfect time for any task:\n- Discover available time slots\n- Smart recommendations for focus time\n- Respects your scheduling preferences\n- Avoids fragmentation\n\n## Quick Start\n\n1. **Install the plugin**:\n   ```bash\n   claude plugin install https://github.com/kjenney/personal-assistant-plugin\n   ```\n\n2. **Set up Google Cloud credentials** (see [SETUP.md](SETUP.md))\n\n3. **Authenticate with Google** on first use\n\n4. **Start using**:\n   ```\n   /morning-brief\n   ```\n\n## Setup\n\nSee [SETUP.md](SETUP.md) for detailed installation and configuration instructions.\n\n## Requirements\n\n- Claude Code\n- Node.js and npm\n- Google account\n- Google Cloud Platform account (free tier)\n\n## MCP Servers\n\nThis plugin uses two Model Context Protocol servers:\n- **Gmail MCP** (`@gongrzhe/server-gmail-autoauth-mcp`) - For email integration with automatic OAuth authentication\n- **Google Calendar MCP** (`@cocal/google-calendar-mcp`) - For calendar integration\n\nBoth servers are automatically configured and managed by the plugin.\n\n## Privacy \u0026 Security\n\n- OAuth 2.0 authentication with encrypted token storage\n- No data is stored or transmitted outside of Google and Claude\n- Minimal required permissions (read/modify emails, manage calendar)\n- All operations require explicit user consent\n\n## How It Works\n\nThe Personal Assistant plugin combines:\n1. **MCP Servers**: Connect to Gmail and Google Calendar APIs\n2. **Slash Commands**: Provide structured workflows for common tasks\n3. **Hooks**: Add contextual awareness and automation\n4. **Claude's Intelligence**: Understand natural language and provide smart recommendations\n\n## Example Usage\n\n**Morning routine**:\n```\n/morning-brief\n```\n\n**During the day**:\n```\nWhat emails do I need to respond to?\n/meeting-prep next\nShow me my afternoon schedule\n```\n\n**Scheduling**:\n```\n/free-time 2hours tomorrow afternoon\nSchedule a meeting with John next week for 1 hour\n```\n\n**End of day**:\n```\n/email-summary today\nWhat do I have tomorrow morning?\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues or pull requests.\n\n## License\n\nMIT License - See LICENSE file for details\n\n## Support\n\nFor issues and questions:\n- Check [SETUP.md](SETUP.md) for troubleshooting\n- Review [Claude Code documentation](https://docs.claude.com/en/docs/claude-code)\n- File an issue in this repository","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkjenney%2Fpersonal-assistant-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkjenney%2Fpersonal-assistant-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkjenney%2Fpersonal-assistant-plugin/lists"}