Pinecone Developer MCP Server
Official Pinecone MCP server: documentation search, index creation, record upserts and search from your agent
Install
{
"mcpServers": {
"pinecone": {
"command": "npx",
"args": ["-y", "@pinecone-database/mcp"],
"env": {
"PINECONE_API_KEY": "<your pinecone api key>"
}
}
}
}Put it in .cursor/mcp.json in the project or home directory. The same snippet works for claude_desktop_config.json.
This is third-party code. Review the repository files before installing.
What it does
The server connects the agent to a Pinecone vector database project and its documentation. The agent can search the docs, list indexes, read their configuration and per-namespace statistics. With an API key it creates indexes with an integrated embedding model, upserts records and searches them with metadata filters and reranking. It also offers search across several indexes and standalone document reranking.
Who it is for. For developers building search or RAG on Pinecone who want to configure and test indexes from their editor.
Good fit when
- You need to choose an index configuration for your use case and create it right away
- You want to test search quality on your data without leaving the editor
- You need Pinecone code grounded in current documentation
Not a fit when
- Your indexes lack integrated inference, which the server does not support
- You want agent access to a knowledge base via Pinecone Assistant, which has a separate Assistant MCP
Example request
List all my Pinecone indexes and search my-docs for records about authenticationLimitations
Only indexes with integrated inference are supported; plain vector search and standalone embeddings are not. Working with indexes needs a Pinecone API key; without it only documentation search works. Requires Node.js 20 or newer. Access to Pinecone from Russia without a VPN is unverified.
How to disable. Remove the pinecone block from mcp.json or claude_desktop_config.json. For Gemini CLI remove the extension with gemini extensions uninstall.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| PINECONE_API_KEY secret | API key from the Pinecone console. Without it only documentation search works. |
Security check
- Creates indexes and writes data to an external service
- Uses a secret API key
README in short
The README lists the server's capabilities and tools: docs search, index listing and description, stats, model-based index creation, record upserts and search, cascading search and reranking. It gives npx configurations for Cursor and Claude Desktop and installation as a Gemini CLI extension. Limitations and common Node.js, key and network issues are covered separately. Apache 2.0 licensed.
FAQ
Does it work without a key?
Yes, but only for Pinecone documentation search. Managing and querying indexes needs a key.
Why does search on my index fail?
Most likely the index has no integrated embedding model. The server supports only such indexes, so create a new one with a model.
Related
166 skills for scientific work: bioinformatics, cheminformatics, clinical data, geospatial analysis and 100+ databases
Google's open-source MCP server for databases: ready tools for Postgres, MySQL, BigQuery, Spanner and more, plus custom tools in tools.yaml
Official Hugging Face skills: Hub operations via the hf CLI, datasets, model training, Spaces, evals and deployment
A token-lean MCP server for PostgreSQL, MySQL, MariaDB, SQL Server and SQLite with a read-only mode