gemini-desktop

gemini-desktop

MCP.Pizza Chef: kkrishnan90

A desktop app for Mac and Windows where you chat with Gemini and attach extra tools, with each tool call shown as it succeeds or fails. In practice it cannot hold a conversation today: the four models it offers are fixed in the source and every one has been shut down by Google, including Gemini 2.0 Flash in June 2026, and the app rejects any name outside that list. The setup notes are wrong too — the wrong key name, the wrong start-up file, and the wrong port. Nothing has changed since August 2025.

Unmaintained · No commits in 13 months.
Coding
Other

Use This MCP client To

Chat with Gemini in a desktop window instead of a browser Attach a tool and watch when Gemini decides to call it Read answers with proper formatting and equations Switch between Gemini models from a settings box Try out a tool I built before wiring it up elsewhere

README

GemCP Chat Logo

GemCP Chat

The GemCP app is a cross-platform desktop application that creates a seamless chat interface for Google's Gemini AI models with extensible capabilities through a Model Context Protocol (MCP) framework.

✨ Features

  • 🤖 Gemini Integration: Seamless chat interface with Google's Gemini models (configurable via Settings).
  • 🔧 Extensible Tools (MCP): Connect external tools and data sources via the Model Context Protocol.
    • Supports Python-based MCP servers (added via file path).
    • Supports command-based MCP servers (e.g., Node.js) defined in a JSON configuration file.
  • 🖥️ Cross-Platform: Runs on macOS and Windows (Electron build).
  • 📊 Tool Status UI: Provides visual feedback when Gemini is calling an MCP tool and whether it succeeded or failed.
  • ⚙️ Model Selection: Choose different Gemini models (e.g., 1.5 Flash, 1.5 Pro, 2.5 Pro Exp) through the Settings dialog.
  • 📝 Markdown & LaTeX Rendering: Displays AI responses with formatting.

Screenshots

Weather Tool Example
Example of the weather tool in action

Chat Interface
Main chat interface with Gemini

Calculator Tool Example
Using the calculator tool with Gemini

Overview

This repository contains both a Python backend and an Electron-based desktop application for interacting with Gemini.

Project Structure

  • mcp-gemini-desktop/: Frontend Electron application
  • python_backend/: Python backend server

gemini-desktop FAQ

Does it actually work right now?
Not without editing the code. The four models it can choose from are hard-coded, all of them have been retired by Google, and any other name is refused, so messages fail.
Do I need a key?
Yes, a Google Gemini key. Be warned that the instructions tell you to set GOOGLE_API_KEY while the code only ever reads GEMINI_API_KEY, so following the guide leaves it unable to start.
Does it cost money?
The app is free, but Gemini usage bills to your Google account once you pass the free allowance.
Where does my key end up?
If you type it into the settings box it is held in memory only and disappears when you quit, so you re-enter it each time unless you put it in an environment file.
Can I use this to run tools I already have?
In principle yes — it accepts Python tool files and command-launched ones listed in a settings file — but the dead model list stops the conversation before any tool is reached.
How hard is setup?
Hard. You install Python 3.13 and the uv tool, start a background service by hand in a terminal, then launch the desktop app separately, and the published steps point at the wrong file and port.
Is it maintained?
No code has changed since August 2025, which is why the model list has been overtaken by Google's retirements.
Which computers does it run on?
Mac and Windows, with ready-made installers included in the project.