Settings Reference
Everything you can configure in MeghaOS, in one place.
Everything is configured in the Settings app — there are no files to edit. This page is a quick reference to the available options. For a walkthrough, see Configuration.
AI
| Setting | Notes |
|---|---|
| Provider | 25+ built-in (OpenRouter, OpenAI, Anthropic, Gemini, Groq, DeepSeek, Mistral, …), local runners (Ollama, LM Studio, vLLM), or any Custom OpenAI-compatible API. See AI Providers. |
| API key | Required for hosted providers; not needed for local models |
| Model | The specific model to run |
AI settings are live — changes apply on the next request, no restart. See LLM Providers.
Integrations
All optional — configure only what you use.
| Integration | What you provide |
|---|---|
| Mailbox sign-in (send / read / search) | |
| Calendar | Works built-in; optional Google Calendar sync |
| Slack / Discord / Telegram / Signal | A bot token per platform |
| Social (Twitter/X, LinkedIn) | Account API keys |
| News | A news API key (for the live news ticker) |
| GitHub | Account connection (repos, issues, PRs) |
| MCP servers | External tool providers (details) |
Apple integrations (iMessage, FaceTime, Apple Mail, Notes, Reminders, Contacts, and more) are macOS-only and need no extra credentials — just the relevant macOS permissions. See Editions & Platforms.
Appearance
| Setting | Options |
|---|---|
| Theme | dark (default) · light · glassmorphic |
| Wallpaper | Your chosen background |
See Theming.
Privacy & data
MeghaOS is a closed, self-contained system. Your data — chats, calendar, saved widget state, memory, and credentials — stays on your device. Requests go only to the AI provider you choose, or stay fully on-device with a local model.
Behavior
A few system behaviors come tuned out of the box and need no configuration — for example, how long a workflow step may run and how many steps run in parallel. These defaults keep the assistant responsive.