Skip to main content
The official Pinecone plugin for Cursor 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.

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

Installation

1

Set your API key

Add your Pinecone API key to a .env file at your workspace root:
PINECONE_API_KEY=your-key
Cursor loads this file into the MCP server via its envFile field, so you don’t need to export the key in your shell.
2

Install the plugin

In Cursor chat, run:
/add-plugin pinecone
Or install directly from the Cursor Marketplace.
3

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

Available skills

SkillCommandDescription
Help/pinecone-helpOverview of all skills and setup requirements.
Quickstart/pinecone-quickstartInteractive onboarding β€” create an index, upsert data, and query. Choose between a Database path or Assistant path.
Query/pinecone-querySearch integrated indexes using natural language via the Pinecone MCP server.
Assistant/pinecone-assistantCreate, upload, sync, and chat with Pinecone Assistants for document Q&A with citations.
CLI/pinecone-cliGuide for using the Pinecone CLI (pc) from the terminal.
Full-text search/pinecone-full-text-searchCreate, ingest into, and query a Pinecone full-text-search (FTS) index using the preview API.
MCP/pinecone-mcpReference for all Pinecone MCP server tools.
Docs/pinecone-docsCurated 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.

Resources