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:
-
Install the plugin:
/plugin install pinecone
-
Restart Claude Code to activate the plugin.
Option B: Pinecone Marketplace
Alternatively, install directly from the Pinecone marketplace:
-
Add the Pinecone plugin marketplace:
/plugin marketplace add pinecone-io/pinecone-claude-code-plugin
-
Install the plugin:
/plugin install pinecone@pinecone-claude-code-plugin
-
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)
-
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]
Note: Only works with integrated indexes that use Pinecone's hosted embedding models.
/pinecone:assistant
All-in-one skill for Pinecone Assistants — create, upload, sync, chat, context retrieval, and list. Works with both slash commands and natural language:
- "Create a Pinecone assistant from my docs"
- "Upload files from ./docs to my-assistant"
- "Sync my assistant with the docs folder"
- "Ask my assistant about authentication"
- "Search my assistant for context about embeddings"
Learn more: https://docs.pinecone.io/guides/assistant/quickstart
/pinecone:cli
Guide for using the Pinecone CLI (pc) to manage resources from the terminal. The CLI supports all index types and vector operations.
/pinecone:mcp
Reference for all Pinecone MCP server tools — parameters, usage, and examples.
/pinecone:docs
Curated documentation reference with links to official docs organized by topic and data format references.
MCP Server Tools
The plugin includes the full Pinecone MCP Server with the following tools:
pinecone-io