Gemini CLI Extension ↗

pinecone guide intermediate tool-use
no
Summary: Install the official Pinecone extension for Gemini CLI to get skills and MCP tools for managing indexes and building AI applications.

Original Documentation

Documentation Index#

Fetch the complete documentation index at: https://docs.pinecone.io/llms.txt Use this file to discover all available pages before exploring further.

Install the official Pinecone extension for Gemini CLI to get skills and MCP tools for managing indexes and building AI applications.

export const PrimarySecondaryCTA = ({primaryLabel, primaryHref, primaryTarget, secondaryLabel, secondaryHref, secondaryTarget}) => {primaryLabel && primaryHref && 

  {primaryLabel}

<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
  <path d="M9.70492 6L8.29492 7.41L12.8749 12L8.29492 16.59L9.70492 18L15.7049 12L9.70492 6Z" fill="white" />
</svg>
}

{secondaryLabel && secondaryHref && 

    {secondaryLabel}
  
</a>

}

;

The official Pinecone extension for Gemini CLI provides AI-powered skills and MCP server integration directly in your terminal. Use natural language to manage indexes, query data, build RAG applications, and create document Q&A assistants.

<PrimarySecondaryCTA primaryLabel={“View on GitHub”} primaryHref={“https://github.com/pinecone-io/gemini-cli-extension"} primaryTarget={"_blank”} />

Features#

  • 7 built-in skills for index management, semantic search, assistant creation, and more
  • MCP server integration for direct Pinecone operations from Gemini CLI
  • Natural language activation — just describe what you want and the right skill is invoked automatically

Prerequisites#

Installation#

    export PINECONE_API_KEY="YOUR_API_KEY"
    ```

Replace `YOUR_API_KEY` with your [Pinecone API key](https://app.pinecone.io/organizations/-/keys).
  <span class="step-end"></span>

  <span class="step-marker" data-step-title="Install the extension"></span>
```shell
    gemini extensions install https://github.com/pinecone-io/gemini-cli-extension
    ```
  <span class="step-end"></span>

  <span class="step-marker" data-step-title="Restart Gemini CLI"></span>
Restart Gemini CLI to activate the extension. Then ask:

```text
    Use the help skill to show me what Pinecone skills are available.
    ```
  <span class="step-end"></span>
<span class="steps-end"></span>

<span class="callout-start" data-callout-type="note"></span>
  If you hit API key errors, exit Gemini CLI, run `export PINECONE_API_KEY="your-key"` in your terminal, and start Gemini CLI again. The CLI only reads environment variables at launch.
<span class="callout-end"></span>

## Available skills

| Skill             | Description                                                                         |
| ----------------- | ----------------------------------------------------------------------------------- |
| **quickstart**    | Step-by-step onboarding — create an index, upload data, and run your first search.  |
| **query**         | Search integrated indexes using natural language text via the Pinecone MCP.         |
| **assistant**     | Create, manage, and chat with Pinecone Assistants for document Q\&A with citations. |
| **cli**           | Guide for using the Pinecone CLI from the terminal.                                 |
| **mcp**           | Reference for all available Pinecone MCP server tools and their parameters.         |
| **pinecone-docs** | Curated links to official Pinecone documentation, organized by topic.               |
| **help**          | Overview of all skills and what you need to get started.                            |

Skills are activated automatically based on your conversation. If the agent doesn't pick up a specific skill, explicitly ask for it: *"Use the quickstart skill to help me get started."*

## MCP tools

The extension includes the Pinecone MCP server, which provides the following tools:

* `search-docs` — Search the official Pinecone documentation.
* `list-indexes` — List all available Pinecone indexes.
* `describe-index` — Get index configuration and namespaces.
* `describe-index-stats` — Get record counts and namespace statistics.
* `create-index-for-model` — Create a new index with integrated embeddings.
* `upsert-records` — Insert or update records in an index.
* `search-records` — Search records with optional metadata filtering and reranking.
* `cascading-search` — Search across multiple indexes with deduplication and reranking.
* `rerank-documents` — Rerank documents using a specified reranking model.

For full MCP server documentation, see [Use the Pinecone MCP server](/guides/operations/mcp-server).

## Resources

* [GitHub repository](https://github.com/pinecone-io/gemini-cli-extension)
* [Pinecone MCP server guide](/guides/operations/mcp-server)
* [Gemini CLI documentation](https://github.com/google-gemini/gemini-cli)
Link last verified June 7, 2026. View original ↗
Source: Pinecone Docs
Link last verified: 2026-04-05