{
  "markdown": "# Postman Gemini CLI Extension\n\nThe Postman Gemini CLI extension connects Postman to your Gemini AI tools and workflows, giving the ability to access workspaces, manage collections and environments, evaluate APIs, and automate workflows through natural language interactions.\n\n## Prerequisites\n\nRequires Gemini CLI v0.40.0 or later.\n\n## Installation\n\nInstall the Postman extension by running the following command in your terminal:\n\n```bash\ngemini extensions install https://github.com/postmanlabs/postman-gemini-cli-extension\n```\n\nTo stay up to date automatically, add the `--auto-update` flag:\n\n```bash\ngemini extensions install https://github.com/postmanlabs/postman-gemini-cli-extension --auto-update\n```\n\n## Authentication\n\nThis extension connects to Postman's hosted MCP server and authenticates via **OAuth** — no API key required. Gemini CLI will open a browser window to complete the Postman login flow on first use.\n\n### API key (alternative)\n\nIf you prefer API key authentication, set your key as an environment variable:\n\n```bash\nexport POSTMAN_API_KEY=your-api-key-here\n```\n\nThen configure the server in Gemini CLI's `settings.json` to read it from the environment:\n\n```json\n{\n  \"mcpServers\": {\n    \"postman\": {\n      \"url\": \"https://mcp.postman.com/minimal\",\n      \"headers\": {\n        \"Authorization\": \"Bearer $POSTMAN_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nAdd the `export` line to your `~/.zshrc` or `~/.bashrc` to persist it across sessions. Get your API key at [postman.postman.co/settings/me/api-keys](https://postman.postman.co/settings/me/api-keys).\n\n## Features\n\n* **AI-powered Postman integration** — Leverages Model Context Protocol (MCP) to provide intelligent and context-aware Postman operations through natural language.\n* **Essential API management** — Access to Postman's core tools for collections, workspaces, environments, specs, and more.\n* **Seamless workflow integration** — Integrates directly into your development environment, making API management an accessible part of your workflow.\n* **Enterprise-ready** — Designed with extensible architecture supporting Postman's Enterprise features and advanced collaboration workflows.\n\n## Tool Configuration\n\nThis extension uses the **minimal** toolset — fast, focused access to core Postman operations.\n\nTo use a different mode, update the URL in your Gemini CLI extension settings:\n\n| Mode | URL | Use when |\n|------|-----|----------|\n| Minimal (default) | `https://mcp.postman.com/minimal` | Collections, workspaces, environments, specs |\n| Full | `https://mcp.postman.com/mcp` | 100+ tools, advanced collaboration, Enterprise |\n| Code | `https://mcp.postman.com/code` | API search and client code generation |\n\n## EU Region\n\nIf your Postman account is in the EU region, use the EU endpoint in your Gemini CLI extension settings:\n\nSet your key as an environment variable first:\n\n```bash\nexport POSTMAN_API_KEY=your-api-key-here\n```\n\nThen configure the EU endpoint in Gemini CLI's `settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"postman\": {\n      \"url\": \"https://mcp.eu.postman.com/minimal\",\n      \"headers\": {\n        \"Authorization\": \"Bearer $POSTMAN_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n> **Note**: OAuth is not supported for the EU region — API key authentication is required.\n\n## Use Cases\n\n* **API testing** — Continuously test your API using Postman collections. Run test suites, view results by endpoint, and get fix suggestions without leaving your terminal.\n* **Code synchronization** — Effortlessly keep your code up to date based on changes made to your [Postman Collections](https://learning.postman.com/docs/collections/collections-overview/) and [specs](https://learning.postman.com/docs/design-apis/specifications/overview/).\n* **Collection management** — Create and tag collections, update collection and request documentation, add comments, or perform actions across multiple collections without leaving your editor.\n* **Workspace and environment management** — Create workspaces and environments, plus manage your environment variables.\n* **Automatic spec creation** — Create specs from your code and use them to generate collections.\n* **Client code generation** — Generate production-ready client code from your API definitions using the `code` toolset.\n",
  "bytes": 4255,
  "sha": "712a07dce09c7a715e2918b633bbb71354a9d395cbe5de41649351a18c59137b",
  "repo_slug": "postmanlabs/postman-gemini-cli-extension",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_postmanlabs_postman_gemini_cli_extension_6e98e27e/readme"
}