Gemini MCP Integration

🚨 MANDATORY: Invoke gemini-cli-docs First

STOP - Before providing ANY response about Gemini MCP:

INVOKE gemini-cli-docs skill

QUERY for the specific MCP topic

BASE all responses EXCLUSIVELY on official documentation loaded

Overview

Expert skill for connecting and managing Model Context Protocol (MCP) servers within the Gemini CLI ecosystem.

When to Use This Skill

Keywords: MCP, model context protocol, mcp servers, mcp config, gemini mcp, stdio transport, sse transport, mcp tool permissions, mcp debugging

Use this skill when:

Adding new MCP servers via settings.json or CLI (gemini mcp add)
Configuring transports: httpUrl, url (SSE), or command (Stdio)
Troubleshooting MCP connection states (CONNECTING, DISCONNECTED)
Managing MCP tool permissions (Trust vs Ask)
Integrating local scripts as MCP servers

MCP Server Configuration

MCP servers are defined in the mcpServers object in settings.json.

Transport Types

Stdio (command): Runs a local executable. Best for local scripts/tools.
```
"local-server": { "command": "node", "args": ["server.js"] }
```
HTTP (httpUrl): Connects via standard HTTP.
SSE (url): Server-Sent Events for streaming updates.

Keyword Registry (Delegates to gemini-cli-docs)

Topic	Query Keywords
Adding Servers	`gemini mcp add command`, `mcpServers settings`
Transports	`mcp transport types`, `stdio vs sse mcp`
Permissions	`mcp tool permissions`, `trust mcp server`
Troubleshooting	`mcp connection error`, `debug mcp server`

Quick Decision Tree

What do you want to do?

Connect a Local Tool -> Query gemini-cli-docs: "configure stdio mcp server"
Connect a Remote API -> Query gemini-cli-docs: "configure http mcp server"
Trust a Server -> Query gemini-cli-docs: "mcp server trust settings"
List Tools -> Query gemini-cli-docs: "list mcp tools command"
Debug Connection -> Query gemini-cli-docs: "troubleshoot mcp connection"

Common Commands

gemini mcp add - Interactive wizard to add a server.
/mcp - List connected servers and their status.
gemini --debug - View raw MCP connection logs (essential for troubleshooting connection issues).

Test Scenarios

Scenario 1: Add MCP Server

Query: "How do I add an MCP server to Gemini CLI?" Expected Behavior:

Skill activates on "MCP" or "mcp servers"
Delegates to gemini-cli-docs for configuration Success Criteria: User receives mcpServers settings.json structure

Scenario 2: Configure Transport

Query: "What transport should I use for my MCP server?" Expected Behavior:

Skill activates on "mcp transport"
Provides comparison of stdio, HTTP, SSE Success Criteria: User receives transport selection guidance

Scenario 3: Debug Connection

Query: "My MCP server isn't connecting to Gemini" Expected Behavior:

Skill activates on "mcp connection error"
Provides debugging steps with --debug flag Success Criteria: User receives troubleshooting workflow

References

Official Documentation: Query gemini-cli-docs for:

"mcp servers"
"mcp configuration"

Version History

v1.1.0 (2025-12-01): Added Test Scenarios section
v1.0.0 (2025-11-25): Initial release

gemini-mcp-integration