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
- Create a virtual environment and install dependencies:
uv sync
- Configure environment variables:
cp .env.example .env
- Run the MCP server (STDIO transport):
uv run aios-cofounder-mcp
Notes
- Google OAuth requires valid
GOOGLE_CLIENT_IDandGOOGLE_CLIENT_SECRET. - Set
OAUTH_REDIRECT_BASE_URLto the public base URL for this server (e.g., an ngrok/cloudflared URL). - Set
GOOGLE_OAUTH_SCOPESto a space- or comma-separated list of scopes. - The OAuth callback is served at
/oauth/google/callbackby this MCP server. - For local dev, start a tunnel to port
8765(default callback bind port) and setOAUTH_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_URLis 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_SECONDSshort in shared environments.