{"id":42223278,"url":"https://github.com/pinecone-io/pinecone-claude-code-plugin","last_synced_at":"2026-03-07T00:03:28.203Z","repository":{"id":329459516,"uuid":"1118379982","full_name":"pinecone-io/pinecone-claude-code-plugin","owner":"pinecone-io","description":"The official Pinecone marketplace for Claude Code Plugins","archived":false,"fork":false,"pushed_at":"2026-02-27T15:55:55.000Z","size":82,"stargazers_count":40,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-27T20:44:28.965Z","etag":null,"topics":["anthropic-claude","claude-code","claude-code-plugin","claude-code-plugin-marketplace","hybrid-search","mcp","pinecone","retrieval-augmented-generation","semantic-search","skills","vector-database"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pinecone-io.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-17T17:02:50.000Z","updated_at":"2026-02-27T15:55:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pinecone-io/pinecone-claude-code-plugin","commit_stats":null,"previous_names":["pinecone-io/pinecone-claude-code-plugin"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/pinecone-io/pinecone-claude-code-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinecone-io%2Fpinecone-claude-code-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinecone-io%2Fpinecone-claude-code-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinecone-io%2Fpinecone-claude-code-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinecone-io%2Fpinecone-claude-code-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pinecone-io","download_url":"https://codeload.github.com/pinecone-io/pinecone-claude-code-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinecone-io%2Fpinecone-claude-code-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30204113,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T19:07:06.838Z","status":"ssl_error","status_checked_at":"2026-03-06T18:57:34.882Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anthropic-claude","claude-code","claude-code-plugin","claude-code-plugin-marketplace","hybrid-search","mcp","pinecone","retrieval-augmented-generation","semantic-search","skills","vector-database"],"created_at":"2026-01-27T02:16:30.046Z","updated_at":"2026-03-07T00:03:28.195Z","avatar_url":"https://github.com/pinecone-io.png","language":"Python","readme":"# Pinecone Plugin for Claude Code\n\nA lightweight plugin that integrates [Pinecone](https://www.pinecone.io/) vector database capabilities directly into Claude Code, enabling semantic search, index management, and RAG (Retrieval Augmented Generation) workflows.\n\n## Features\n\n- **Pinecone Assistant** – Fully managed RAG service for document Q\u0026A with citations, natural language support, and incremental file syncing\n- **Pinecone MCP Server** – Full integration with the Pinecone Model Context Protocol server for index creation, listing, searching, and more\n- **Slash Commands** – Quick access to common Pinecone operations directly from Claude Code\n- **Semantic Search** – Query your vector indexes using natural language\n- **Natural Language Recognition** – Assistant commands work without explicit slash commands\n\n## Installation\n\n### Option A: Claude Code Plugins Directory (Recommended)\n\nInstall from the [official Claude Code Plugins Directory](https://github.com/anthropics/claude-plugins-official):\n\n1. Install the plugin:\n   ```\n   /plugin install pinecone\n   ```\n\n2. **Restart Claude Code** to activate the plugin.\n\n### Option B: Pinecone Marketplace\n\nAlternatively, install directly from the Pinecone marketplace:\n\n1. **Add the Pinecone plugin marketplace:**\n   ```\n   /plugin marketplace add pinecone-io/pinecone-claude-code-plugin\n   ```\n\n2. **Install the plugin:**\n   ```\n   /plugin install pinecone@pinecone-claude-code-plugin\n   ```\n\n3. **When prompted**, select your preferred installation scope:\n   - **User scope** (default) – Available across all your projects\n   - **Project scope** – Shared with your team via version control\n   - **Local scope** – Project-specific, not shared (gitignored)\n\n4. **Restart Claude Code** to activate the plugin.\n\n### Set Your API Key\n\nAfter installing via either method, configure your Pinecone API key before running Claude Code:\n\n```bash\nexport PINECONE_API_KEY=\"your-api-key-here\"\n```\n\n\u003e **Don't have a Pinecone account?** Sign up for free at [app.pinecone.io](https://app.pinecone.io/?sessionType=signup)\n\n\n### Install uv (Required for Assistant Commands)\n\nTo use Pinecone Assistant functionality, you must have uv installed. uv is a fast Python package and project manager:\n\n**macOS and Linux:**\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n**Windows:**\n```powershell\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\n**With Homebrew:**\n```bash\nbrew install uv\n```\n\nAfter installation, restart your terminal and verify with: `uv --version`\n\nFull installation guide: https://docs.astral.sh/uv/getting-started/installation/\n\n### Install the Pinecone CLI (Optional)\n\nFor additional command-line capabilities, install the Pinecone CLI:\n\n```bash\nbrew tap pinecone-io/tap\nbrew install pinecone-io/tap/pinecone\n```\n\n## Available Skills\n\n### `/pinecone:help`\n\nOverview of all available Pinecone skills and what you need to get started. Run this when first installing the plugin.\n\n### `/pinecone:quickstart`\n\nInteractive quickstart for new developers. Choose between two paths:\n- **Database** — Create an integrated index, upsert data, and query using Pinecone MCP + Python\n- **Assistant** — Create a Pinecone Assistant for document Q\u0026A with citations\n\n### `/pinecone:query`\n\nQuery integrated indexes using natural language. Wraps the Pinecone MCP server for easy searching.\n\n```\n/pinecone:query query [your search text] index [indexName] namespace [ns] reranker [rerankModel]\n```\n\n\u003e **Note:** Only works with integrated indexes that use Pinecone's hosted embedding models.\n\n### `/pinecone:assistant`\n\nAll-in-one skill for Pinecone Assistants — create, upload, sync, chat, context retrieval, and list. Works with both slash commands and natural language:\n\n- \"Create a Pinecone assistant from my docs\"\n- \"Upload files from ./docs to my-assistant\"\n- \"Sync my assistant with the docs folder\"\n- \"Ask my assistant about authentication\"\n- \"Search my assistant for context about embeddings\"\n\n**Learn more:** https://docs.pinecone.io/guides/assistant/quickstart\n\n### `/pinecone:cli`\n\nGuide for using the Pinecone CLI (`pc`) to manage resources from the terminal. The CLI supports all index types and vector operations.\n\n### `/pinecone:mcp`\n\nReference for all Pinecone MCP server tools — parameters, usage, and examples.\n\n### `/pinecone:docs`\n\nCurated documentation reference with links to official docs organized by topic and data format references.\n\n## MCP Server Tools\n\nThe plugin includes the full Pinecone MCP Server with the following tools:\n\n| Tool | Description |\n|------|-------------|\n| `list-indexes` | List all available Pinecone indexes |\n| `describe-index` | Get index configuration and namespaces |\n| `describe-index-stats` | Get statistics including record counts and namespaces |\n| `search-records` | Search records with optional metadata filtering and reranking |\n| `create-index-for-model` | Create a new index with integrated embeddings |\n| `upsert-records` | Insert or update records in an index |\n| `rerank-documents` | Rerank documents using a specified reranking model |\n\nFor complete MCP server documentation, visit: [Pinecone MCP Server Guide](https://docs.pinecone.io/guides/operations/mcp-server)\n\n## Troubleshooting\n\n### \"API Key not found\" or access errors\n\nMake sure your `PINECONE_API_KEY` environment variable is set correctly:\n\n```bash\necho $PINECONE_API_KEY\n```\n\nIf it's empty, set it and restart Claude Code.\n\n### MCP server not responding\n\n1. Ensure you have Node.js installed (the MCP server runs via `npx`)\n2. Check that your API key is valid\n3. Restart Claude Code after setting environment variables\n\n### Query command not working with my index\n\nThe `/query` command only works with **integrated indexes** that use Pinecone's hosted embedding models. If you're using external embedding providers (OpenAI, HuggingFace, etc.), you'll need to use the MCP tools directly or wait for expanded support.\n\n### Assistant commands not working\n\nMake sure you have uv installed. uv is required for all assistant commands:\n\n```bash\n# Verify uv is installed\nuv --version\n\n# Install if missing\ncurl -LsSf https://astral.sh/uv/install.sh | sh  # macOS/Linux\n```\n\nAfter installing uv, restart your terminal.\n\n## Keywords\n\n`pinecone` · `semantic search` · `vector search` · `vector database` · `retrieval` · `RAG` · `agentic RAG` · `sparse search` · `document Q\u0026A` · `citations` · `assistant` · `managed RAG`\n\n## License\n\nMIT License – see [LICENSE](./LICENSE) for details.\n\n\n**Have fun and enjoy developing with Pinecone!** 🌲\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinecone-io%2Fpinecone-claude-code-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpinecone-io%2Fpinecone-claude-code-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinecone-io%2Fpinecone-claude-code-plugin/lists"}