database
Pinecone CLI for Headless Automation
Use the Pinecone CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 5 read 2 write Bearer token auth
Pinecone CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Pinecone CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Pinecone CLI for Headless Automation
kosmokrator integrations:configure pinecone --set access_token="$PINECONE_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call pinecone.pinecone_list_indexes '{}' --json Discovery Before Execution
Agents and scripts can inspect Pinecone docs and schemas before choosing a function.
kosmo integrations:docs pinecone --json
kosmo integrations:docs pinecone.pinecone_list_indexes --json
kosmo integrations:schema pinecone.pinecone_list_indexes --json
kosmo integrations:search "Pinecone" --json
kosmo integrations:list --json Useful Pinecone CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
pinecone.pinecone_list_indexes | Read | none | List all vector indexes in your Pinecone project. Returns index names, dimensions, metrics, and status. |
pinecone.pinecone_get_index | Read | name | Get detailed information about a specific Pinecone vector index, including its dimension, metric, host URL, and status. |
pinecone.pinecone_create_index | Write | name, dimension, metric | Create a new serverless vector index in Pinecone. Specify the index name, vector dimension, and similarity metric (cosine, euclidean, or dotproduct). |
pinecone.pinecone_upsert_vectors | Write | index_host, vectors | Upsert vectors into a Pinecone index using an index host URL. |
pinecone.pinecone_query_vectors | Read | index_host, vector, top_k, filter, include_metadata | Search for similar vectors in a Pinecone index using a query embedding. |
pinecone.pinecone_list_collections | Read | none | List all collections in your Pinecone project. Collections are static snapshots of indexes used for backups or creating new indexes. |
pinecone.pinecone_get_current_user | Read | none | Get information about the currently authenticated Pinecone user, including email, name, and project details. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.