Package Information
Documentation
n8n-nodes-cachly
n8n community node for the cachly AI Brain. It stores lessons, looks them up again and keeps short working notes. It can also be used as a tool by an AI agent in n8n.
Version 1 has actions only. There is no memory connector for the AI Agent node yet.
Install
In n8n: Settings, Community Nodes, Install, then enter @cachly-dev/n8n-nodes-cachly.
To let an AI Agent use the node as a tool, start n8n with N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true.
Credentials
Create a credential of type "Cachly API":
| Field | Meaning |
|---|---|
| Instance ID | ID (UUID) of your Brain instance, shown in the cachly dashboard |
| API Key | cachly API key (cky_...), sent as Authorization: Bearer <key> |
| API URL | Default https://api.cachly.dev. Only change it for a self-hosted API. |
The credential test calls GET /api/v1/instances/<Instance ID>.
Operations
| Operation | Like MCP tool | REST call |
|---|---|---|
| Learn | learn_from_attempts |
POST /api/v1/instances/{id}/learn |
| Recall | smart_recall (reduced, see below) |
POST /api/v1/instances/{id}/recall |
| Remember Context | remember_context |
POST /api/v1/instances/{id}/context |
Fields:
- Learn:
topic,outcome(success, partial, failure),what_worked(required unless the outcome is failure), optionalwhat_failed,context,severity,tags,commands,file_paths,author. Put the key fact first inwhat_worked: only the first characters appear in briefings. - Recall:
query(words),limit(1 to 25, API default 8). The REST endpoint filters by words. It does not run the semantic search of the MCP toolsmart_recall. Each recall counts against the monthly recall quota of your plan. - Remember Context:
key,content(cut after 4096 characters),ttlin seconds (default 86400, values above 7 days fall back to 24 hours). The note is stored ascachly:ctx:wip:<key>. The REST endpoint always uses the categorywip; the MCP tool allows other categories.
The API redacts secrets in lessons sent to /learn and flags suspicious instructions (api/internal/handler/instance_handler.go, Learn).
Development
npm install --ignore-scripts # n8n-workflow pulls a native module that is not needed here
npm test
npm run lint
npm run build
Licence
MIT. The package layout follows the n8n community node starter. The structure was inspired by the MIT-licensed postiz-n8n; no code from Postiz itself is used.