ConsoleSun/Gemini-Eyes
60Last commit Aug 15, 2026
Gemini-Eyes DSH plugin
Gemini-Eyes is a MCP server that reuses your logged-in Google session cookie to access gemini.google.com's internal interfaces. It allows AI agents to chat, analyze images/videos, generate images/videos via Imagen/Veo, and manage conversation history, all without official API costs.
How to install the Gemini-Eyes DSH plugin
dsh plugin --profile demo add github:ConsoleSun/Gemini-EyesCopying does not run this command. Review the repository and version before installing the Gemini-Eyes DSH plugin.
Gemini-Eyes DSH plugin data source
Gemini-Eyes DSH plugin snapshot date: Aug 16, 2026
discovered
What the Gemini-Eyes DSH plugin can do
- Multi-turn chat with conversation history
- Upload local images/videos for Gemini to analyze and describe
- Generate images (Imagen) and videos (Veo), auto-download to local
- List, read, and delete historical conversations
- Automatic cookie renewal every 25 minutes to maintain login state
- Diagnostics tool to check cookie integrity and token status
Where the Gemini-Eyes DSH plugin fits
- Let an AI agent visually analyze product photos or screenshots
- Generate marketing images or short videos on demand via agent commands
- Automate conversation management across multiple Gemini accounts
- Build a personal assistant that can see and describe uploaded media
- Integrate Gemini's web-only features (like Veo) into custom workflows
Who the Gemini-Eyes DSH plugin is for
- Developers building MCP-based agents or assistants
- Power users who want to leverage Gemini's web capabilities without API costs
- DSH users who need vision and media generation tools in their agents
Gemini-Eyes DSH plugin limitations
- Requires a valid Google account with Gemini access and manual cookie export (or automatic extraction from Chrome/Edge)
- Not an official API – may break if Google changes internal endpoints, and carries account ban risk
- Only works on desktop platforms where Python 3.10+ and uv can run
- Image/video generation quotas depend on the Google account's Imagen/Veo limits
- Video generation may take 5–15 minutes and requires adjusting timeout settings
Gemini-Eyes DSH plugin: from the repository README
Quoted from the ConsoleSun/Gemini-Eyes README, the upstream source of the Gemini-Eyes DSH plugin. Copyright remains with the original authors.
**让 Agent 用上 Gemini 的「眼睛」和「手」** —— 一个 MCP 服务，把 [gemini.google.com](https://gemini.google.com) 网页端的能力桥接给任何 Agent： - 🗣️ **对话**：多轮聊天、续聊历史会话 - 👁️ **看图 / 看视频**：上传本地文件，让 Gemini 识别并描述 - 🎨 **生图（Imagen）/ 🎬 生视频（Veo）**：自动下载成品到本地 - 💬 **会话管理**：列出 / 读取 / 删除账号下的历史对话 - 🔄 **免维护登录态**：后台每 25 分钟自动续期 Cookie，服务常驻就不过期 **核心特点**：不走官方 API——**不需要 API Key、不产生 API 计费**。它复用你浏览器里 已登录的 Google 会话 Cookie，重放网页端的内部请求，与你在浏览器里使用完全等价 （共享账号历史、共享生成额度）。 > ## ⚠️ 风险提示 > > 本项目是对 Gemini 网页端内部接口的逆向封装，非官方 API；自动化访问可能违反 > Google 服务条款，请合法使用、自行评估风险。**请务必使用专用 Google 小号测试， > 不要使用主力账号**——这类操作有真实的封号风险，且不应用于商业用途或批量抓取。 --- ## 快速开始 环境：Python ≥ 3.10，推荐 [uv](https://docs.astral.sh/uv/)。 ```bash uv sync --extra dev # 安装依赖 ``` ### 1. 准备 Cookie（二选一） **A. 自动提取**：在 Chrome/Edge 登录 gemini.google.com 后**关闭浏览器**： ```bash uv run python -m gemini_mcp.cookie_extractor --browser chrome --list --domain google.com ``` > 新版浏览器改用 portal/app-bound 加密无法离线解密时，程序会明确提示，改用方式 B。 **B. 手动导出**：用浏览器扩展（如 Cookie-Editor）导出 `gemini.google.com` 的全部 Cookie 为 JSON。**全量导出、一个不落**；其中 `__Secure-1PSID` 必带，浏览器里有 `__Secure-1PSIDTS` 则必须一起带。保存位置三选一： - **默认路径** `~/.config/gemini-web-mcp/cookies.json` —— 服务自动读取，零配置 - 任意路径 + 启动参数 `--cookie-file /path/to/cookies
Read the full READMEThe repository declares no license. Check with the authors before using it.
Gemini-Eyes DSH plugin questions
How do I get the cookie for Gemini-Eyes?
You can either automatically extract it from Chrome/Edge by closing the browser and running `uv run python -m gemini_mcp.cookie_extractor`, or manually export cookies from gemini.google.com using a browser extension like Cookie-Editor. Save the JSON to `~/.config/gemini-web-mcp/cookies.json` or specify a custom path via `--cookie-file` or `GEMINI_COOKIE_FILE` environment variable.
Does Gemini-Eyes work with free Gemini accounts?
Yes, it works with any Google account that has access to gemini.google.com, including free accounts. However, free accounts have lower generation quotas for Imagen and Veo, and may be rate-limited more aggressively. The tool itself does not require any API key or billing.
Can I use Gemini-Eyes without DeepSeek Harness?
Absolutely. Gemini-Eyes is a standard MCP server. You can connect it to any MCP client like Claude Desktop, Cline, or even custom applications via HTTP transport. See the README for configuration examples for different clients.
Why do I see errors like '401' or 'SNlM0e parsing failed'?
These errors indicate that your session cookie has expired or is invalid. Re-export fresh cookies from gemini.google.com. The service automatically renews cookies every 25 minutes, so once you set it up correctly, it should stay valid. If you manually exported cookies, make sure you included all necessary cookies, especially `__Secure-1PSID` and `__Secure-1PSIDTS` if present.
Is it safe to use Gemini-Eyes with my main Google account?
No, it is not recommended. The README explicitly warns that using this tool may violate Google's terms of service and carries a real risk of account ban. Always use a dedicated test Google account (a 'throwaway' account) for testing. Do not use this for commercial purposes or bulk scraping.