API Reference

Settings

Reference for every settings section in Mobile Agent, from providers and jobs to plugins and prompts.

The Settings tab is the control center for Mobile Agent. Everything below is configurable there (sections correspond roughly to the settings tree).

Providers

Manage model providers:

  • Add/remove cloud providers — OpenAI, Anthropic, Google, xAI, OpenRouter, Ollama, and custom OpenAI-compatible profiles — with OAuth or API keys.
  • Manage on-device models — browse and download from the on-device catalog.
  • Set model presets (default model per provider) and reasoning effort.
  • See provider connection status, model discovery, and errors.

MCP

Manage MCP servers:

  • Connected — servers you've added, with status, tool count, and server info.
  • List — browse the preset catalog and add servers.
  • Test connections, configure transport (HTTP/SSE), auth none/headers/OAuth, and OAuth scopes — see MCP Servers.

Skills

Manage skills:

  • Create, edit, enable/disable, import, export, copy, and delete skills.
  • Set autoMatch and matchKeywords.
  • Review attached files and recommended MCP servers/tools — see Skills.

Agents

Manage custom agents:

  • Create/edit agents with custom prompts, docs, model, temperature.
  • Set mode (primary / subagent / all), hidden/enabled flags.
  • Configure per-agent tool permissions (built-in tools + MCP servers) — see Custom Agents.

Plugins

Manage JavaScript plugins:

  • Import a plugin file (see Plugin API).
  • Toggle enabled, edit options, check update status.
  • Configure secrets per plugin (stored encrypted, never sent to the model).

Jobs

Manage scheduled jobs:

  • Create schedules with frequency/cron, model, agent, autoApprove, timezone, folder sessions.
  • See next/last run times and run history — see Scheduler.

Memory

Manage persistent memory:

  • View and edit stored facts (memory.md).
  • Enable/disable memory, switch local/remote database mode.
  • Review memory event history (created / updated / deleted) — see Memory.

Prompts

Manage saved prompts:

  • Save reusable prompt templates.
  • Insert them into the composer.
  • Edit and delete saved prompts.

Tools

Manage built-in tools:

Notifications

Choose which events notify you:

  • approvalRequests — tool approval requests while backgrounded.
  • runFinished — scheduled/manual run completion or failure.

General app settings

  • Appearance / theme — system, light, or dark.
  • Database mode — local or remote (for shared/remote memory and data).
  • Scheduling enabled — master toggle for the background scheduler.
  • Tool approval mode — default ask/auto behavior.
  • Update checks — version checks against GitHub Releases (cached 60 min, prerelease-aware).

Where data lives

All settings, conversations, memory, schedules, skills, agents, plugin configs, and MCP server configs are persisted on-device in the app's SQLite database (Drizzle + expo-sqlite). Credentials and secrets use the encrypted secret store — see the Architecture reference for the data model.