> ## 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.

# Cursor Plugin

> Integrate Pinecone with the Cursor plugin for vector search, RAG, and production AI workloads.

export const PrimarySecondaryCTA = ({primaryLabel, primaryHref, primaryTarget, secondaryLabel, secondaryHref, secondaryTarget}) => <div style={{
  display: 'flex',
  alignItems: 'center',
  gap: 16
}}>
   {primaryLabel && primaryHref && <div style={{
  width: 'fit-content',
  height: 42,
  background: 'var(--brand-blue)',
  borderRadius: 4,
  overflow: 'hidden',
  flexDirection: 'column',
  justifyContent: 'center',
  alignItems: 'center',
  display: 'inline-flex'
}}>
      <a href={primaryHref} target={primaryTarget} style={{
  paddingLeft: 22,
  paddingRight: 22,
  paddingTop: 8,
  paddingBottom: 8,
  justifyContent: 'center',
  alignItems: 'center',
  gap: 4,
  display: 'inline-flex',
  textDecoration: 'none',
  borderBottom: 'none'
}}>
        <div style={{
  textAlign: 'justify',
  color: 'var(--text-contrast)',
  fontSize: 15,
  fontWeight: '600',
  letterSpacing: 0.46,
  wordWrap: 'break-word'
}}>
          {primaryLabel}
        </div>
        <svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" style={{
  marginLeft: 2
}}>
          <path d="M9.70492 6L8.29492 7.41L12.8749 12L8.29492 16.59L9.70492 18L15.7049 12L9.70492 6Z" fill="white" style={{
  fille: "var(--text-contrast)"
}} />
        </svg>
      </a>
    </div>}

    {secondaryLabel && secondaryHref && <div style={{
  width: 'fit-content',
  height: 42,
  borderRadius: 4,
  overflow: 'hidden',
  flexDirection: 'column',
  justifyContent: 'center',
  alignItems: 'center',
  display: 'inline-flex',
  textDecoration: 'none'
}}>
        <a href={secondaryHref} target={secondaryTarget} style={{
  paddingLeft: 11,
  paddingRight: 11,
  paddingTop: 8,
  paddingBottom: 8,
  justifyContent: 'center',
  alignItems: 'center',
  gap: 8,
  display: 'inline-flex',
  textDecoration: 'none',
  borderBottom: 'none'
}}>
          <div style={{
  textAlign: 'justify',
  color: 'var(--brand-blue)',
  fontSize: 15,
  fontWeight: '600',
  letterSpacing: 0.46,
  wordWrap: 'break-word'
}}>
            {secondaryLabel}
          </div>
        </a>
      </div>}

  </div>;

The official Pinecone plugin for [Cursor](https://www.cursor.com/) provides AI-powered skills, MCP server integration, and slash commands directly in your editor. Use natural language to manage indexes, query data, build RAG applications, and create document Q\&A assistants — all with up-to-date Pinecone API knowledge.

<PrimarySecondaryCTA primaryLabel={"View on GitHub"} primaryHref={"https://github.com/pinecone-io/pinecone-cursor-plugin"} primaryTarget={"_blank"} />

## Features

* **8 built-in skills** for index management, semantic search, full-text search, assistant creation, and more
* **Bundled MCP server** (`@pinecone-database/mcp`) for direct Pinecone operations from Cursor Agent
* **Slash commands** like `/pinecone-quickstart` and `/pinecone-query` for quick access
* **Natural language activation** — Cursor Agent invokes the right skill automatically based on your conversation

## Prerequisites

* A [Pinecone API key](https://app.pinecone.io/organizations/-/keys)
* [Cursor](https://www.cursor.com/) installed
* [Node.js](https://nodejs.org/) v18+ (required for the bundled MCP server)
* [uv](https://docs.astral.sh/uv/getting-started/installation/) installed (optional, runs bundled Python scripts)
* [Pinecone CLI](/reference/cli/quickstart) installed (optional, enables the `pinecone-cli` skill)

## Installation

<Steps>
  <Step title="Set your API key">
    Add your [Pinecone API key](https://app.pinecone.io/organizations/-/keys) to a `.env` file at your workspace root:

    ```text theme={null}
    PINECONE_API_KEY=your-key
    ```

    Cursor loads this file into the MCP server via its [`envFile`](https://cursor.com/docs/mcp) field, so you don't need to export the key in your shell.
  </Step>

  <Step title="Install the plugin">
    In Cursor chat, run:

    ```text theme={null}
    /add-plugin pinecone
    ```

    Or install directly from the [Cursor Marketplace](https://cursor.com/marketplace/pinecone).
  </Step>

  <Step title="Verify the installation">
    Open Cursor Agent chat and run `/pinecone-help` to confirm the skills are loaded. You can also check:

    * **Skills:** Cursor Settings > Rules — listed under "Agent Decides"
    * **MCP server:** Cursor Settings > Features > Model Context Protocol
  </Step>
</Steps>

## Available skills

| Skill                | Command                      | Description                                                                                                         |
| -------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Help**             | `/pinecone-help`             | Overview of all skills and setup requirements.                                                                      |
| **Quickstart**       | `/pinecone-quickstart`       | Interactive onboarding — create an index, upsert data, and query. Choose between a Database path or Assistant path. |
| **Query**            | `/pinecone-query`            | Search integrated indexes using natural language via the Pinecone MCP server.                                       |
| **Assistant**        | `/pinecone-assistant`        | Create, upload, sync, and chat with Pinecone Assistants for document Q\&A with citations.                           |
| **CLI**              | `/pinecone-cli`              | Guide for using the Pinecone CLI (`pc`) from the terminal.                                                          |
| **Full-text search** | `/pinecone-full-text-search` | Create, ingest into, and query a Pinecone full-text-search (FTS) index using the preview API.                       |
| **MCP**              | `/pinecone-mcp`              | Reference for all Pinecone MCP server tools.                                                                        |
| **Docs**             | `/pinecone-docs`             | Curated links to official Pinecone documentation.                                                                   |

## MCP tools

The plugin 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/pinecone-cursor-plugin)
* [Cursor Marketplace listing](https://cursor.com/marketplace/pinecone)
* [Pinecone MCP server guide](/guides/operations/mcp-server)
* [Cursor documentation](https://cursor.com/docs)