Gemini Terminal Agent

@Nghiauet

About Gemini Terminal Agent

create agent with mcp server

#mcp-agent #gemini-terminal-agent #terminal-agent

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-agent-nghiauet": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Gemini Terminal Agent?

Gemini Terminal Agent is a terminal-based agent that uses Google’s Gemini model and integrates real‑time web search via Google Custom Search Engine. It is intended for developers and power users who want a conversational AI interface directly in their terminal.

How to use Gemini Terminal Agent?

Install Python 3.9+, clone the repository, create a virtual environment, install dependencies, and add your API keys to a .env file. Run python main.py to start the agent. Type prompts or questions, and use commands such as help, clear, and exit.

Key features of Gemini Terminal Agent

Conversational AI interface using Google’s Gemini models
Web search integration for up‑to‑date information
Conversation history maintained across turns
Advanced search options (domain filtering, exclusions, time range)
Clean, modular architecture that is easy to extend

Use cases of Gemini Terminal Agent

Ask questions and receive Gemini‑powered answers from the terminal
Perform real‑time web searches without leaving the command line
Maintain multi‑turn context for deeper technical discussions

FAQ from Gemini Terminal Agent

What is the difference between Gemini Terminal Agent and the Gemini web UI?

Gemini Terminal Agent runs locally in your terminal and adds built‑in web search capabilities, which the standard Gemini web interface does not provide.

What are the runtime dependencies?

Python 3.9 or higher, a Google Gemini API key, and a Google Custom Search Engine (CSE) API key with its corresponding CSE ID.

Where is conversation history stored?

History is kept in memory for the duration of the session. It can be cleared by typing the clear command.

What search features are available?

The agent supports both basic and advanced web search, including domain filtering, site exclusion, and time‑range options.

How do I configure the model and search settings?

All settings are managed through the .env file, where you can set the model name, maximum concurrent requests, timeouts, and cache TTL.

Frequently asked questions

What is the difference between Gemini Terminal Agent and the Gemini web UI?

Gemini Terminal Agent runs locally in your terminal and adds built‑in web search capabilities, which the standard Gemini web interface does not provide.

What are the runtime dependencies?

Python 3.9 or higher, a Google Gemini API key, and a Google Custom Search Engine (CSE) API key with its corresponding CSE ID.

Where is conversation history stored?

History is kept in memory for the duration of the session. It can be cleared by typing the `clear` command.

What search features are available?

The agent supports both basic and advanced web search, including domain filtering, site exclusion, and time‑range options.

How do I configure the model and search settings?

All settings are managed through the `.env` file, where you can set the model name, maximum concurrent requests, timeouts, and cache TTL.

Comments

Basic information

More AI & Agents MCP servers

Plainpaper

The AI marketing canvas for Claude and MCP agents. Your agent drafts campaigns as cards on a shared board, briefed by your brand rules, approved by you.

Legion MCP

faulkj

MCP-native LLM councils for debates, juries, blind panels, voting, refinement, and custom multi-model deliberation.

Nero AI Image Processing

nero-com

We provide AI-powered tools for image enhancement, upscaling, background removal, photo restoration, colorization, denoising, and compression. All features are available through our API documentation.

BlazingCDN MCP - Content Delivery for Video, Software & Static Files

BlazingCDN

Official MCP server for BlazingCDN - AI agents (Claude, Cursor, Windsurf) manage CDN resources, purge cache, query metrics, domains, Anycast CDN, Video CDN and Media CDN

Hypnothera

La-Salida

Agent skill: turn what your AI assistant knows about you into a personalized hypnosis session on hypnothera.ai