Gemini CLI MCP configuration
Gemini CLI defines servers inside an mcpServers object. Local servers use command and args; remote servers commonly use httpUrl. MCP Config Lab normalizes the source format and emits the Gemini field names.
{
"mcpServers": {
"docs": {
"httpUrl": "https://mcp.example.com/mcp",
"headers": {
"Authorization": "Bearer ${DOCS_TOKEN}"
}
}
}
}
Generate Gemini config →
Local and remote transports
For a local stdio server, keep the executable in command and each argument as a separate item in args. For a remote server, use a secure HTTPS endpoint and pass credentials as environment-variable references where supported.
Keep configs portable
Avoid editor-specific workspace variables when a configuration will be shared across clients. The converter reports fields such as Cursor’s envFile or Cline permissions instead of silently pretending every client supports them.