aios-cofounder-mcp

Production-ready MCP server for a Business Co-Founder / Executive Assistant.

Features

• FastMCP server over STDIO by default
• Lightweight SQLite storage for assistant state
• Google OAuth + Gmail, Calendar, Contacts tools
• Web search + fetch helpers
• Approval gating for sensitive actions

Setup

1. Create a virtual environment and install dependencies:

uv sync

2. Configure environment variables:

cp .env.example .env

3. Run the MCP server (STDIO transport):

uv run aios-cofounder-mcp

Notes

• Google OAuth requires valid GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET.
• Set OAUTH_REDIRECT_BASE_URL to the public base URL for this server (e.g., an ngrok/cloudflared URL).
• Set GOOGLE_OAUTH_SCOPES to a space- or comma-separated list of scopes.
• The OAuth callback is served at /oauth/google/callback by this MCP server.
• For local dev, start a tunnel to port 8765 (default callback bind port) and set OAUTH_REDIRECT_BASE_URL=https://<public-domain>.
• By default the server uses SQLite at ./aios_cofounder_mcp.db.
• Tools that modify external systems require approval before execution.

Known limitations

• Free/busy uses the primary calendar only.
• OAuth callback listener is always started when OAUTH_REDIRECT_BASE_URL is set.

TODO

• Consolidate OAuth error mapping for client display.
• Add pagination for repository list endpoints.

Ops notes

• SQLite file and parent directory are created on first run.
• Keep OAUTH_STATE_TTL_SECONDS short in shared environments.