Mosyn connector documentation
Mosyn is an Android study app. This connector lets Claude or another assistant build your study sets for you: you paste a list into the assistant you already have open, and the cards appear on your phone as it writes them. The assistant can also write a custom study game for that material, in code, which loads on the phone as it is written.
This page covers setup, everyday use, the full tool surface, limits, troubleshooting, data deletion, and how sign-in works. Questions not answered here: [email protected].
Before you connect
Install the Mosyn app on your Android phone and sign in: you approve every connection there. The app is free, and adding the connector costs nothing. Download Mosyn.
Setup
The server URL is https://mosyn.lycatra.com/mcp. Every assistant adds it differently: Claude with one link, Claude Code, Codex and Gemini CLI with one command, editors through their MCP settings. ChatGPT supports it on Business, Enterprise and Edu.
Everyday use
Ask in plain language. The assistant decides which tools to call.
- “Here are the 30 people in my cohort. Make me a set with their photos.” An assistant with web search can find a picture for each name, attach them, and add the cards.
- “Add the irregular verbs from chapter 4 to my French set.”
- “Build me a game for the anatomy set: clicking the right region on a diagram.” The assistant writes the code and it appears on your phone.
- “That game is broken.” The assistant reads the errors your phone reported and fixes its own code.
Everything a tool writes syncs to the phone; there is no import step and no file.
Tools
The connector exposes 16 tools. Read-only tools are marked; the two destructive ones require an explicit confirmation and say so when called without it.
| Tool | What it does |
|---|---|
list_sets (read-only) | Lists your study sets. |
get_set (read-only) | Reads one set, optionally with its cards. |
create_set | Creates a set. |
update_set | Renames a set or changes its description. |
delete_set (destructive) | Deletes a set and its cards. Requires confirm: true. |
add_cards | Adds up to 50 cards per call. |
update_card | Rewrites one side of a card. |
delete_cards (destructive) | Deletes specific cards. Requires confirm: true. |
reorder_cards | Sets the card order for a set. |
attach_media | Fetches images or audio from URLs the assistant found and stores them. |
create_experience | Creates a custom study experience from a file bundle. |
update_experience_files | Edits an experience; the phone reloads it live. |
get_experience (read-only) | Reads an experience and its files. |
publish_experience | Promotes a draft experience to published. |
get_component_library_docs (read-only) | Serves the Mosyn Kit documentation the assistant builds experiences against. |
get_device_feedback (read-only) | Returns runtime errors your phone reported, so the assistant can fix its own code. |
Limits
Per-call limits, enforced by the server. When a call exceeds one, the error states the limit and what to do instead, so the assistant can correct itself without you stepping in.
- 50 cards per
add_cardscall, and 10 URLs perattach_mediacall. - 2,000 characters per card side.
- 20 files per experience, 256 KB per file, 1 MB per bundle.
Account limits depend on your plan. The free plan includes 3 sets, 100 cards, 25 MB of media, and 1 custom experience. When you reach one, the assistant is told the limit has been reached and tells you; it is never shown a price or a purchase link, and no assistant can make a purchase. Plans are managed in the app and on the pricing page.
Sign-in and approval
The connector uses OAuth 2.1 with PKCE and dynamic client registration, so assistants register themselves and no key or password is ever pasted. When an assistant connects, it opens a Mosyn page with an eight-character code and a QR code. You approve the request in the Mosyn app on your phone: scan the QR code, open the link on the phone, or type the code in Settings → Connect an assistant → Have a code? The request expires after ten minutes. The assistant never receives your Google or Lycatra credentials.
Approving creates a grant scoped to your account and to that assistant. One grant cannot read or write another account’s data. Grants are listed in the app under Settings → Connected assistants and can be revoked there individually. Revocation is immediate: an assistant holding a revoked grant is refused on its next call, including mid-conversation.
Troubleshooting
| Symptom | What it means |
|---|---|
| The assistant says it cannot find your sets, or the tool list is empty. | The grant was revoked or expired. Remove the connector in the assistant and add it again. |
| The approval page says the request expired. | Start the connection again from the assistant and approve it in the app within ten minutes. |
| Nothing appears in the app when you try to approve. | Make sure the app is installed and signed in, then scan the QR code again or type the code in Settings → Connect an assistant → Have a code? |
| Cards were created but the phone does not show them. | The phone applies changes when it is online and in the foreground. Open the app; it catches up from its last position. Nothing is lost by being offline. |
| An image failed to attach. | The URL was a web page rather than an image file. The error tells the assistant to find the direct image URL and retry; asking it to try again is usually enough. |
| A custom experience shows an error on the phone. | The phone keeps the previous working version and reports the error. Ask the assistant to check get_device_feedback; it can read the failure and fix its own code. |
Security
Custom experiences are code written by an assistant, so they run in a sandbox with no network access: no fetch, no sockets, no remote fonts or images, and no navigation off their own origin. Each experience gets its own isolated origin and can only read the media belonging to its own set.
Session tokens are opaque and stored only as hashes. Media is served over per-user signed URLs that expire. Study history stays on your phone: a connected assistant can write cards, and cannot see how you are doing.
Deleting your data
Delete individual sets or cards by asking the assistant, or in the app. To delete your account and everything in it, use Settings → Delete account in the Android app; this removes your sets, cards, media, experiences, and grants. You can also request deletion by writing to [email protected] from the address on your account. See deleting your data.