executive-copilot
Integrates with Asana as a task provider, allowing AI assistants to access and manage assigned tasks, including overdue task retrieval.
Integrates with Gmail as an email provider, allowing AI assistants to access inbox emails, search messages, and track follow-ups on sent emails awaiting replies.
Integrates with Google Calendar as a calendar provider, allowing AI assistants to retrieve today's schedule, upcoming events, and prepare for meetings.
Scans Google Meet meeting transcripts to extract action items and follow-ups from meetings.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@executive-copilotWhat's on my schedule today and which emails need follow-ups?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Executive Copilot
An MCP (Model Context Protocol) server that provides AI assistants with access to an executive's digital workspace. Aggregates data from email, calendar, tasks, and documents to enable intelligent assistance.
Features
MCP Interface: Works with Claude Desktop, ChatGPT, Cursor, and any MCP-compatible client
Multi-Provider Architecture: Pluggable providers for Outlook, Gmail, Google Calendar, Asana, and more
Context Engine: Intelligently determines which information sources to consult
Memory Layer: Persistent knowledge base for organizations, people, and decisions
Automation Engine: Scheduled jobs for synchronization and briefings
Follow-up Detection: Automatically tracks sent emails awaiting replies
Transcript Scanning: Extracts action items from meeting transcripts (Google Meet)
Related MCP server: google-mcp-server
Quick Start
Prerequisites
Python 3.12+
uv (Python package manager)
Installation
# Clone the repository
git clone https://github.com/gppsys/personalcopilot.git
cd personalcopilot
# Install dependencies
uv sync
# Copy and configure your settings
cp config/organizations.example.yaml config/organizations.yaml
# Edit config/organizations.yaml with your accounts
# Optional: local overrides and extra rules (all gitignored)
cp config/config.local.example.yaml config/config.local.yaml
cp config/context_rules.example.yaml config/context_rules.yaml
cp config/email_forward_rules.example.yaml config/email_forward_rules.yaml
# Initialize database
uv run copilot db init
# Run MCP server
uv run copilot mcpConnect to Claude Desktop
Add to your Claude Desktop configuration:
{
"mcpServers": {
"executive-copilot": {
"command": "uv",
"args": ["--directory", "/path/to/personalcopilot", "run", "copilot-mcp"]
}
}
}Architecture
┌─────────────────────────────────────────────────────────────────┐
│ MCP Layer │
│ (FastMCP server with tool definitions) │
├─────────────────────────────────────────────────────────────────┤
│ Service Layer │
│ (EmailService, CalendarService, ContextService, etc.) │
├─────────────────────────────────────────────────────────────────┤
│ Domain Layer │
│ (Models, Business Rules, Value Objects) │
├─────────────────────────────────────────────────────────────────┤
│ Infrastructure Layer │
│ (Providers, Repositories, Database, Config) │
└─────────────────────────────────────────────────────────────────┘Available MCP Tools
Tool | Description |
| Get recent inbox emails |
| Search emails with query |
| Get pending follow-ups and reminders |
| Get today's calendar events |
| Get upcoming events |
| Get assigned tasks |
| Get overdue tasks |
| Get context for upcoming meeting |
| Combined daily briefing |
| Get organization information |
| Unified search across sources |
| Search knowledge base |
Running the Copilot
Option A: With Background Automation (Recommended)
Run the server with automatic follow-up detection and scheduled jobs:
# Start admin panel + automation engine
uv run copilot serve
# In Claude Desktop config, connect to MCP server separatelyThis runs:
Admin panel at http://localhost:8080
Background automation (follow-up detection at 9am & 2pm, email sync, etc.)
Option B: Components Separately
# MCP server only (for Claude Desktop)
uv run copilot mcp
# Admin panel only (no automation)
uv run copilot admin
# Manual sync of pending replies
uv run copilot sync-repliesCLI Commands
Command | Description |
| Run admin panel with background automation |
| Run the MCP server (for Claude Desktop) |
| Initialize database tables |
| Run the admin web panel only |
| Manually scan sent emails for pending replies |
| Show current configuration |
| Run terminal configuration UI |
Configuration
Configuration is managed through YAML files in the config/ directory:
config.yaml- Base configurationorganizations.yaml- Organization definitions (create from.example.yaml)context_rules.yaml- Context engine rulesautomation.yaml- Scheduled job configuration
See Configuration Guide for details.
Development
# Install dev dependencies
uv sync --dev
# Run tests
uv run pytest
# Run linter
uv run ruff check .
# Type checking
uv run mypy srcSee Development Guide for detailed instructions.
Documentation
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server providing comprehensive email capabilities via IMAP and SMTP, enabling AI assistants to read, search, send, manage, schedule, and analyze emails across multiple accounts.Last updated4910,69785LGPL 3.0
- Flicense-qualityBmaintenanceAn MCP server that enables AI assistants to read, search, and act on Google Workspace services including Gmail, Drive, Docs, YouTube, and Calendar.Last updated
- Alicense-qualityBmaintenanceAn MCP server that receives emails on your domain and allows AI assistants to search, read, and manage them via natural language queries.Last updated1,110MIT
- Alicense-qualityDmaintenanceAn MCP server that enables AI assistants to interact with Google Calendar and Gmail, allowing users to manage events, send emails, and organize their inbox through natural language.Last updatedMIT
Related MCP Connectors
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
MCP server for LeadDelta — manage LinkedIn connections and CRM data via AI assistants.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/gppsys/personalcopilotmcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server