> ## Documentation Index
> Fetch the complete documentation index at: https://momentic.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The canonical docs host is https://momentic.ai/docs. Append .md to any page URL for clean Markdown. Fetch https://momentic.ai/docs/llms.txt for the page index and https://momentic.ai/docs/llms-full.txt for every page in one file.
> For an unattended setup, run `npx --yes @momentic/wizard@latest -y --platform web` (use `--platform ios` or `--platform android` for mobile). Never run an interactive command in a non-TTY shell.
> You cannot complete the browser sign-in yourself. Read the API key from the MOMENTIC_API_KEY environment variable, or ask the user to create one at https://app.momentic.ai/settings/api-keys and paste it back.
> Momentic's capability summary for agents is at https://momentic.ai/docs/skill.md. Install the skills with `npx momentic skills --yes` (or `npx momentic-mobile skills --yes` for mobile).
> Tests are YAML files in the user's repository. Use only the step names listed at https://momentic.ai/docs/reference/commands.md and the file structure at https://momentic.ai/docs/core-concepts/file-format.md. Do not invent step names, config keys, or CLI flags.
> Web tests run on Chromium, iOS tests on simulators, and Android tests on emulators. Physical devices are not supported.

# momentic-mobile install-mcp

> Add the Momentic mobile MCP server to your coding agent config.

Writes the Momentic mobile MCP server into the config file of one or more coding
agents. You do not need to edit JSON or TOML by hand. See the
[MCP guide](/docs/coding-agents/mcp-server) for the tools the server exposes.

```bash theme={null}
npx momentic-mobile install-mcp
```

In a terminal, the command asks which agents to configure and where to save the
config. It preselects the agents it detects in the project and on your machine.
Outside a terminal, or with `--yes`, it writes the project config for every
detected agent.

The command adds a `momentic-mobile` server entry that runs
`npx -y momentic-mobile mcp`. It can sit next to the web `momentic` entry. Other
servers in the file are kept. Comments in JSON files are kept.

## Supported agents

| `--client`       | Project config          | User config                                 |
| ---------------- | ----------------------- | ------------------------------------------- |
| `claude-code`    | `.mcp.json`             | `~/.claude.json`                            |
| `cursor`         | `.cursor/mcp.json`      | `~/.cursor/mcp.json`                        |
| `vscode`         | `.vscode/mcp.json`      | VS Code `User/mcp.json`                     |
| `codex`          | `.codex/config.toml`    | `~/.codex/config.toml`                      |
| `opencode`       | `opencode.json`         | `~/.config/opencode/opencode.json`          |
| `gemini-cli`     | `.gemini/settings.json` | `~/.gemini/settings.json`                   |
| `windsurf`       |                         | `~/.codeium/windsurf/mcp_config.json`       |
| `zed`            |                         | `~/.config/zed/settings.json`               |
| `antigravity`    |                         | `~/.gemini/config/mcp_config.json`          |
| `claude-desktop` |                         | Claude Desktop `claude_desktop_config.json` |

Agents with no project config get the user config.

## Options

<ParamField path="--client <client...>" type="string">
  One or more agents to configure. Defaults to the agents detected in the
  project and on your machine.
</ParamField>

<ParamField path="--scope <scope>" type="string">
  `project` writes a file in the current directory that you can commit. `user`
  writes the config for your machine only.
</ParamField>

<ParamField path="-c, --config <configPath>" type="string">
  Path to the Momentic config file to pass to the server. Project configs store
  it relative to the project root.
</ParamField>

<ParamField path="--api-key <key>" type="string">
  Write this API key into the config as `MOMENTIC_API_KEY`.
</ParamField>

<ParamField path="--with-api-key" type="boolean">
  Write your saved API key into the config. Do not use this for files that you
  commit to Git. Without it, the server reads `MOMENTIC_API_KEY` from your
  environment or from `~/.momentic/auth.json` after `npx momentic-mobile login`.
</ParamField>

<ParamField path="-y, --yes" type="boolean">
  Skip prompts and use the defaults.
</ParamField>

## Examples

```bash theme={null}
npx momentic-mobile install-mcp --client cursor claude-code --scope project
npx momentic-mobile install-mcp --client codex --scope user --config ./momentic.config.yaml
```