topoteretes/cognee / .agents/skills/cognee-integrations
cognee-integrations
VerifiedUse when the user wants to connect cognee to external services — switching LLM or embedding providers (OpenAI, Azure, Gemini, Anthropic, Ollama, OpenRouter), changing databases (Postgres, PGVector, Neo4j, Neptune, Turso), S3 storage, or the MCP server for IDE integration.
Set up cognee integrations
All integration config is environment variables (.env). The authoritative,
always-current list with commented examples is .env.template at the repo
root — check it before inventing variable names. Install the matching extra
before switching a backend (e.g. pip install cognee[postgres]).
LLM providers
Default is OpenAI (LLM_API_KEY is all you need). To switch, set
LLM_PROVIDER, LLM_MODEL, LLM_API_KEY, and (where relevant)
LLM_ENDPOINT / LLM_API_VERSION:
- Azure OpenAI:
LLM_PROVIDER=azure,LLM_MODEL=azure/gpt-4o-mini, endpoint + api version required. - Gemini (no extra needed):
LLM_PROVIDER=gemini,LLM_MODEL=gemini/gemini-2.0-flash-exp. - Anthropic (
cognee[anthropic]):LLM_PROVIDER=anthropic, model e.g.claude-sonnet-5-5. - Ollama, local (
cognee[ollama]):LLM_PROVIDER=ollama,LLM_ENDPOINT=http://localhost:11434/v1, and set the embedding block +HUGGINGFACE_TOKENIZERtoo. - Custom / OpenRouter / vLLM:
LLM_PROVIDER=customwith the provider's OpenAI-compatible endpoint. - AWS Bedrock (
cognee[aws]):LLM_PROVIDER=bedrock+ AWS credentials/region.
The classic trap: LLM and embeddings are configured independently
(EMBEDDING_PROVIDER, EMBEDDING_MODEL, EMBEDDING_ENDPOINT,
EMBEDDING_API_KEY). Configuring only one leaves the other on OpenAI —
either keep a valid OpenAI key or configure both.
Databases
- Relational (
DB_PROVIDER): sqlite (default) or postgres (cognee[postgres]; host/port/user/password/name viaDB_*vars). - Vector (
VECTOR_DB_PROVIDER): lancedb (default), pgvector (cognee[postgres], needsVECTOR_DB_URL), neptune_analytics (cognee[neptune]), turso (cognee[turso]). Anything else (ChromaDB, Qdrant, Weaviate, Milvus, …) lives in community adapters — install from https://github.com/topoteretes/cognee-community and register withuse_vector_adapterbefore use; settingVECTOR_DB_PROVIDERalone raises "Unsupported vector database provider". - Graph (
GRAPH_DATABASE_PROVIDER): ladybug (default), neo4j (cognee[neo4j], bolt URL + credentials), neptune (cognee[neptune]), ladybug-remote, postgres (no raw Cypher / natural-language search).
The repo docker-compose.yml ships ready-to-use postgres (pgvector) and
neo4j profiles with matching default credentials. From a container, reach
host services with DB_HOST=host.docker.internal.
Storage, cache, and the rest
- S3 storage (
cognee[aws]):STORAGE_BACKEND=s3+ bucket/credentials, and pointDATA_ROOT_DIRECTORY/SYSTEM_ROOT_DIRECTORYats3://paths. - Session cache:
CACHE_BACKEND= sqlite (default) | postgres | redis | tapes. - Ontologies:
ONTOLOGY_FILE_PATHto an OWL file, resolver/matching viaONTOLOGY_RESOLVER/MATCHING_STRATEGY.
MCP server (IDE integration)
docker compose --profile mcp up starts the MCP server on port 8001
(Streamable HTTP at http://localhost:8001/mcp), built from cognee-mcp/. Point Cursor / Claude Desktop /
Claude Code at it to use cognee memory from the IDE. Configure its DB_* env
to match the main service so both see the same data.
After changing providers mid-project
Embeddings from different models are not comparable — after switching the
embedding provider or model, reset local state (cognee-cli forget --all or
await cognee.forget(everything=True)) and re-ingest with remember().
To drop just the graph and vectors while keeping the ingested files, use
await cognee.forget(dataset="my_project", memory_only=True) — the dataset can
then be rebuilt under the new embedding model without re-uploading anything.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |