Gemini CLI + MagicScreenshots

App Store screenshots in Gemini CLI

• Search real App Store screenshots and preview videos from the top apps
• Use them as design reference for your own app
• Generate and localize your own App Store screenshots

How do I add MagicScreenshots to Gemini CLI?

terminal

gemini mcp add --transport http magicscreenshots https://www.magicscreenshots.com/api/mcp

1. Run the gemini mcp add command in your terminal.
2. Start Gemini CLI.
3. Ask for App Store screenshots from any category, look or chart.
4. For generation, re-add the server with your key in an Authorization header.

What is Gemini CLI?

Gemini CLI is Google's open-source AI agent for the terminal. It runs on Gemini models, works on files and shell commands, and can call tools from MCP servers added with gemini mcp add or in settings.json.

Do I need an API key?

Search works with no key. For restyle and localize, add the server with an Authorization header, or set headers under the httpUrl entry in ~/.gemini/settings.json.

gemini mcp add --transport http --header "Authorization: Bearer $MAGICSCREENSHOTS_API_KEY" magicscreenshots https://www.magicscreenshots.com/api/mcp

MCP, skill or CLI: which should I use?

• MCP server: Most people
• CLI: Scripts, CI and one-off lookups

FAQ

How do I connect MagicScreenshots to Gemini CLI?

Run the gemini mcp add command in your terminal. Then start Gemini CLI. The server URL is https://www.magicscreenshots.com/api/mcp.

Do I need an API key to use MagicScreenshots in Gemini CLI?

Search works with no key. For restyle and localize, add the server with an Authorization header, or set headers under the httpUrl entry in ~/.gemini/settings.json.

Is the MagicScreenshots MCP server free?

Searching the library is free and needs no account. Generating your own screenshots uses credits. Listing history and preview video downloads are part of Library Pro.

Which App Store screenshots can Gemini CLI find?

About 4,700 real App Store listings: the top 100 free and top-grossing apps in every Apple category, refreshed daily. Search by name, category, look or chart position.

Can Gemini CLI get App Store preview videos?

Yes. Poster frames are free for everyone. With a Library Pro API key, get_app_videos also returns download links to the preview video files.

Can Gemini CLI make App Store screenshots for my app?

Yes, with an API key. Ask it to restyle your screenshots like an app from the library with create_restyle, or localize them with create_localize. The first time, it calls create_api_key and you open the claim link to sign in and buy credits.

Is MagicScreenshots made by Google?

No. MagicScreenshots is an independent product that works with Gemini CLI through the open Model Context Protocol. It is not affiliated with or endorsed by Google.

Other agents

• Claude Code
• Cursor
• Codex
• Claude
• ChatGPT
• Windsurf
• VS Code + GitHub Copilot
• Zed
• Cline
• Lovable
• Bolt
• v0
• Replit Agent
• Figma Make
• Perplexity
• Grok Build
• Kimi Code
• OpenClaw
• Hermes Agent
• Paperclip
• NanoClaw

Last updated September 2026 · AI agents guide

Product names and logos are trademarks of their owners. MagicScreenshots is not affiliated with or endorsed by them.