New—Millions at Stake: How Melange's High-Recall Retrieval Prevents Litigation Collapse - Read the case study

Building apps with Pinecone and Claude Code just got way easier. We've launched the official Pinecone Plugin for Claude Code—now available in the Anthropic Claude Code Plugin Marketplace.

This plugin brings Pinecone's vector database and managed RAG service directly into your development workflow, alongside preset skills, slash commands, MCP, and other handy shortcuts to get started building with Claude Code, faster.

Search and manage indexes, query Assistants, and build intelligent applications—all without leaving Claude Code.

Why Use the Pinecone Plugin?

  • Natural language commands: Just tell Claude what you want, like "search my index for machine learning docs" or "create an assistant from my research-docs folder"
  • Explicit commands: Need precision? Use commands like /pinecone:query or /pinecone:assistant-chat for explicit access to integrated tooling
  • Complete vector database toolkit: Create indexes, upsert vectors, search with metadata filters, get statistics—everything you need to manage your vector data.
  • Generate code for Pinecone: use /pinecone:quickstart to learn how to build with Pinecone, and setup your development environment
  • Managed RAG with Pinecone Assistant: Upload documents, sync changes, and get cited answers with page numbers. No custom chunking or embedding pipeline required.

Getting Started in 60 Seconds

Install the Pinecone Plugin easily from Anthropic's Claude Code marketplace

1. Set your API key

Add your Pinecone API key as an environment variable:

export PINECONE_API_KEY=your-api-key-here

2. Install the plugin in Claude Code

claude plugin install pinecone

3. Start building

Restart Claude Code, then ask Claude to use Pinecone:

  • Claude, list my Pinecone indexes
  • Build a Pinecone Assistant from the pdfs in my local folder, and then suggest some great queries to retrieve them

Or use a slash command for semantic search:

/pinecone:query query "your query here" index your-index-name

That's it. You're ready to build!

Work with Pinecone Vector Database and Pinecone Assistant all through Claude Code

Vector Search and Index Management

Work with your vector data using natural language or explicit commands:

  • Search your indexes: Run semantic searches with /pinecone:query or just ask Claude to "search my index for X"
  • Manage indexes: List, create, and describe indexes using natural language or MCP tools
  • Insert and update vectors: Use upsert-records to add data to your indexes
  • Advanced filtering: Search with metadata filters and rerank results for better relevance
  • Get insights: Check index statistics including record counts and namespace details

Note: The /pinecone:query command works only with integrated indexes using Pinecone's hosted embedding models. For third-party embeddings (OpenAI, HuggingFace, etc.), you'll need to generate scripts instead

Managed RAG with Pinecone Assistant

Pinecone Assistant handles the entire RAG pipeline—chunking, embedding, retrieval, and citation—so you can focus on building your application. Remember, that you can invoke any of these commands just by asking Claude Code too!

  • Create an assistant
    • /pinecone:assistant-create --name product-docs-assistant
  • Upload your documents
    • Upload files or entire directories (PDF, Markdown, TXT, DOCX, JSON):
    • /pinecone:assistant-upload --assistant product-docs-assistant --source ./documentation
  • Keep docs in sync
    • Only upload new or changed files:
    • /pinecone:assistant-sync --assistant product-docs-assistant --source ./documentation
  • Get cited answers
    • /pinecone:assistant-chat --assistant product-docs-assistant --message "How do I configure authentication?"
  • Retrieve context for custom workflows
    • Get relevant snippets without a full chat response:
    • /pinecone:assistant-context --assistant product-docs-assistant --query "rate limiting"

The plugin remembers your last assistant, so you can use natural language for follow-ups: "Ask my assistant about API endpoints."

Important: Assistant commands require uv to be installed. Run uv --version to check, or see our troubleshooting guide below.

And, you can infinitely compose any of these capabilities to build better search and RAG experiences with Pinecone. Such as:

  • Upload my research-papers to an assistant, then generate five queries that retrieve those documents well
  • Search my support-tickets index for urgent customer issues, and rerank the top results
  • Create an assistant from my legal-contracts folder, then ask it to find clauses related to termination rights and explain the key provisions

Get Started Now

Install the Pinecone Plugin and start building context-aware applications:

claude plugin install pinecone

Happy building!

Share:

Was this article helpful?

Recommended for you
Further Reading

Start building knowledgeable AI today

Create your first index for free, then pay as you go when you're ready to scale.