Pinecone Plugin for Claude Code

A lightweight plugin that integrates Pinecone vector database capabilities directly into Claude Code, enabling semantic search, index management, and RAG (Retrieval Augmented Generation) workflows.

Features

• Pinecone Assistant – Fully managed RAG service for document Q&A with citations, natural language support, and incremental file syncing
• Pinecone MCP Server – Full integration with the Pinecone Model Context Protocol server for index creation, listing, searching, and more
• Slash Commands – Quick access to common Pinecone operations directly from Claude Code
• Semantic Search – Query your vector indexes using natural language
• Natural Language Recognition – Assistant commands work without explicit slash commands

Installation

Option A: Claude Code Plugins Directory (Recommended)

Install from the official Claude Code Plugins Directory:

1. Install the plugin:

   /plugin install pinecone
   

2. Restart Claude Code to activate the plugin.

Option B: Pinecone Marketplace

Alternatively, install directly from the Pinecone marketplace:

1. Add the Pinecone plugin marketplace:

   /plugin marketplace add pinecone-io/pinecone-claude-code-plugin
   

2. Install the plugin:

   /plugin install pinecone@pinecone-claude-code-plugin
   

3. When prompted, select your preferred installation scope:

   • User scope (default) – Available across all your projects
   • Project scope – Shared with your team via version control
   • Local scope – Project-specific, not shared (gitignored)

4. Restart Claude Code to activate the plugin.

Set Your API Key

After installing via either method, configure your Pinecone API key before running Claude Code:

export PINECONE_API_KEY="your-api-key-here"

Don't have a Pinecone account? Sign up for free at app.pinecone.io

Install uv (Required for Assistant Commands)

To use Pinecone Assistant functionality, you must have uv installed. uv is a fast Python package and project manager:

macOS and Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

With Homebrew:

brew install uv

After installation, restart your terminal and verify with: uv --version

Full installation guide: https://docs.astral.sh/uv/getting-started/installation/

Install the Pinecone CLI (Optional)

For additional command-line capabilities, install the Pinecone CLI:

brew tap pinecone-io/tap
brew install pinecone-io/tap/pinecone

Available Skills

/pinecone:help

Overview of all available Pinecone skills and what you need to get started. Run this when first installing the plugin.

/pinecone:quickstart

Interactive quickstart for new developers. Choose between two paths:

• Database — Create an integrated index, upsert data, and query using Pinecone MCP + Python
• Assistant — Create a Pinecone Assistant for document Q&A with citations

/pinecone:query

Query integrated indexes using natural language. Wraps the Pinecone MCP server for easy searching.

/pinecone:query query [your search text] index [indexName] namespace [ns] reranker [rerankModel]