Personal Assistant Claude Setup Template

This repository contains a template for setting up a personal assistant using Claude with integrations for Notion and Google Workspace. It's designed to be a starting point for creating your own automated personal assistant.

Prerequisites

Before you begin, ensure you have the following:

• Claude Code: This setup is designed to be used with Cursor.
• mcp-gsuite-enhanced: For Google Calendar and Gmail integration.
• Notion MCP Server: For Notion integration.
• Python 3.10+: For running the analysis scripts.
• A Notion account and a Google account.

Setup Instructions

Pro-tip: You can use Claude Code to automate much of this setup. Just ask it to configure the project for you by replacing the placeholders with your information.

1. Configure CLAUDE.md

This is the core file that defines your assistant's identity, responsibilities, and workflows.

1. Open claude-setup/CLAUDE.md.
2. Replace all placeholder values (e.g., [YOUR_NAME], [WORK_EMAIL], [YOUR_WORK_TASK_DATABASE_ID]) with your actual information.
   • Calendars: Add your work and personal calendar IDs.
   • Notion Databases: Create the necessary databases in Notion (Sprints, Meetings, Work Tasks, Personal Tasks) and get their IDs.
   • Notion User ID: Find your Notion user ID.

2. Set Up Notion

1. Create the databases in Notion that you referenced in CLAUDE.md.
2. Ensure the properties in your Notion databases match the ones used in the scripts and CLAUDE.md (e.g., "Tags", "Sprint", "Due Date").

3. Configure Scripts

The scripts/ directory contains Python scripts for task analysis.

1. Open claude-setup/scripts/personal_task_analyzer.py and claude-setup/scripts/work_task_analyzer.py.
2. Replace the placeholder database and user IDs at the top of each file with your Notion IDs.

This template includes customized task analyzer scripts (personal_task_analyzer.py and work_task_analyzer.py) designed to fetch tasks in bulk from your Notion databases. This approach provides context to the agent more efficiently than querying tasks one by one.

Depending on your specific Notion database structure and properties, you may need to modify these scripts. Alternatively, you can always ask Claude to interact with your Notion databases directly to get task information.

4. Set Up Environment Variables

The scripts require a Notion API token.

1. Create a .env file in the root of your project directory.
2. Add your Notion integration token to the .env file:

   NOTION_TOKEN="your_notion_api_token"
   

5. Install Dependencies

The Python scripts have dependencies that need to be installed.

1. It is recommended to use a virtual environment:

   python3 -m venv venv
   source venv/bin/activate

2. Install the required packages:

   pip install -r requirements.txt

   (Note: You may need to create a requirements.txt file if one doesn't exist. Based on the scripts, you will need python-dotenv and notion-client.)

6. Using the Assistant

With the setup complete, you can now use your personal assistant.

• Daily Routine: Use the daily-routine.md command to trigger your assistant's morning workflow.
• Task Analysis: Run the Python scripts to get reports on your work and personal tasks.

Customization

This is a template, so feel free to customize it to your needs.

• Modify CLAUDE.md: Adjust the assistant's personality, responsibilities, and workflows.
• Update Templates: Change the templates in the templates/ directory to match your preferred formats for daily schedules, sprint planning, and standup notes.
• Extend Scripts: Add more functionality to the Python scripts for more in-depth analysis.

---

This template is provided as-is. You are responsible for managing your own data and API keys securely.