Skip to main content
Glama

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 mcp

Connect 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_inbox

Get recent inbox emails

search_emails

Search emails with query

get_follow_ups

Get pending follow-ups and reminders

today_schedule

Get today's calendar events

upcoming_events

Get upcoming events

my_tasks

Get assigned tasks

overdue_tasks

Get overdue tasks

prepare_for_meeting

Get context for upcoming meeting

daily_summary

Combined daily briefing

organization_context

Get organization information

search_everything

Unified search across sources

recall_memory

Search knowledge base

Running the Copilot

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 separately

This 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-replies

CLI Commands

Command

Description

copilot serve

Run admin panel with background automation

copilot mcp

Run the MCP server (for Claude Desktop)

copilot db init

Initialize database tables

copilot admin

Run the admin web panel only

copilot sync-replies

Manually scan sent emails for pending replies

copilot config

Show current configuration

copilot tui

Run terminal configuration UI

Configuration

Configuration is managed through YAML files in the config/ directory:

  • config.yaml - Base configuration

  • organizations.yaml - Organization definitions (create from .example.yaml)

  • context_rules.yaml - Context engine rules

  • automation.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 src

See Development Guide for detailed instructions.

Documentation

License

MIT

Install Server
A
license - permissive license
B
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

  • A
    license
    A
    quality
    C
    maintenance
    An 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 updated
    49
    10,697
    85
    LGPL 3.0
  • A
    license
    -
    quality
    B
    maintenance
    An MCP server that receives emails on your domain and allows AI assistants to search, read, and manage them via natural language queries.
    Last updated
    1,110
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    An 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 updated
    MIT

View all related MCP servers

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.

View all MCP Connectors

Latest Blog Posts

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