Mobbin for Raycast
Search Mobbin for screens, product flows, and website sections without leaving Raycast.
Unofficial extension. This community project is not affiliated with, endorsed by, or operated by Mobbin. “Mobbin” and the Mobbin logo belong to their respective owner. You use the extension with your own Mobbin account or API key.
Features
- Debounced natural-language search across iOS and web references.
- Dedicated commands for screens, selected text, flows, and website sections.
- Ordered screen galleries for multi-step flows.
- OAuth MCP onboarding by default for new installations.
- REST API mode for existing Team and Enterprise integrations.
- Persistent favorites with local image copies and a 20-entry search history.
- Safe local image actions: download, copy, paste, Quick Look, and expiring-URL warnings.
- Immediate result metadata with progressively loaded images and large two-column reference grids.
- Deep and Standard search modes, configurable limits, and screen exclusions.
Commands
| Command | Availability | Description |
|---|---|---|
| Search Mobbin | REST or OAuth MCP | Search iOS and web screens. |
| Search Selected Text | REST or OAuth MCP | Use editable selected text as a screen query. Text over 500 characters is blocked before transmission. |
| Search Mobbin Flows | OAuth MCP | Search multi-step flows and open their ordered screens. |
| Search Mobbin Sections | OAuth MCP | Search website sections such as pricing pages and footers. |
Authentication and plans
New installations default to OAuth MCP. Existing installations keep their stored authentication preference.
| Mode | Mobbin plan | Capabilities |
|---|---|---|
| OAuth MCP | Pro, Team, or Enterprise | Screens, flows, and sections through Mobbin’s Streamable HTTP MCP server. Raycast handles OAuth, dynamic client registration, PKCE, refresh tokens, and secure token storage. |
| REST API Key | Team or Enterprise | Screen search through POST /v1/screens/search. Mobbin’s documented REST API does not expose flows or sections. |
Choose the mode in the extension preferences. In OAuth mode, open any search command and run Connect Mobbin OAuth from the action panel. To revoke the server-side grant later, use Manage or Revoke Mobbin Access or visit Mobbin MCP settings. Local Disconnect removes Raycast’s stored credentials but does not revoke the Mobbin-side grant.
Official references: Mobbin overview, REST screen search, MCP integration, and rate limits.
Search and image behavior
Queries are trimmed and must contain 1–500 characters. Search starts 700 ms
after typing stops. Superseded requests are cancelled, successful results are
cached in memory for two minutes, and rate-limit responses are retried at most
three times while respecting Retry-After.
Mobbin image URLs can expire. The extension therefore separates three types of files:
- Copy, paste, and Quick Look use an internal temporary cache.
- Adding a favorite stores a dedicated persistent local image when possible. The favorite is still retained if that download fails.
- Download Image creates a unique, sanitized file in
~/Downloads.
Images must be served over HTTPS with an image/* content type and are limited
to 25 MB. Temporary cache files older than 30 days are pruned, with at most 200
nonfavorite files retained. Search and flow grids show all result metadata
immediately, then cache and reveal remote images one at a time. Changing the
query cancels the old image queue, while already cached images appear
immediately.
Preferences
- Authentication Mode — OAuth MCP or REST API Key.
- Mobbin API Key — used only by REST mode.
- Default Platform — iOS or Web.
- Default Search Mode — Deep or Standard.
- REST Image Quality — Optimized or High.
- MCP Image Format — WebP or JPEG.
- Default Result Limit — 10, 20, 50, or 100. MCP requests are clamped to each advertised tool schema.
Development
Requires macOS, Raycast, and a current Node.js LTS release.
npm ci
npm run typecheck
npm run eslint
npm run format:check
npm test
npm run lint
npm run build
The test fixtures contain only synthetic structural values. Never commit Mobbin credentials, authorization parameters, signed URLs, or downloaded reference images.
License
MIT © Niklas Schmidt
