# Add Mosyn to Gemini CLI

MCP URL: https://mosyn.lycatra.com/mcp

## Steps

1. Add Mosyn for your user (the default scope is the current project).
2. Start `gemini`; the first Mosyn call opens the sign-in, or run `/mcp auth mosyn`.

## Commands

Add Mosyn:

```sh
gemini mcp add --transport http --scope user mosyn https://mosyn.lycatra.com/mcp
```

Check it:

```sh
gemini mcp list
```

## Config file

`~/.gemini/settings.json`:

```json
{
  "mcpServers": {
    "mosyn": {
      "httpUrl": "https://mosyn.lycatra.com/mcp"
    }
  }
}
```

## Sign in

Gemini CLI discovers Mosyn's sign-in, registers itself and opens the approval page in your browser. `/mcp auth mosyn` starts it again.

## Approve on your phone

A browser page from Mosyn opens with an eight-character code and a QR code. Open the Mosyn app on your phone and approve the request there (scan the QR code, tap the link on the phone, or type the code in Settings → Connect an assistant → Have a code?).

Never paste the code into a chat; it goes into the Mosyn app only.

## Check that it worked

`/mcp` shows mosyn as CONNECTED with its tools.

## If something goes wrong

| What you see | What to do |
| --- | --- |
| Sign-in fails over SSH. | Gemini CLI needs a local browser for the callback. Sign in on your own computer. |
| The config uses `url` and connects over SSE. | `url` means SSE. Use `httpUrl` for Mosyn. |
| Mosyn keeps asking to sign in. | Run `/mcp auth mosyn`, and check that ~/.gemini/mcp-oauth-tokens.json is writable. |

## Sources

- https://geminicli.com/docs/tools/mcp-server/
- https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md

Last checked 2026-09-26. All assistants: https://mosyn.lycatra.com/connect.md
