Skip to content

Databases ​

If your orders, customers or inventory live in a database, connect it and ask Pencel about them in plain English. Pencel writes the query, runs it and explains the answer. You don't need to know SQL.

What Pencel can do with it ​

  • "How many orders did we ship last week, and what was the average order value?"
  • "Which customers haven't ordered in 90 days?"
  • "Which products are below their reorder level?"
  • "Turn this into a weekly sales summary." Then click Save as workflow on the reply to get it every Monday. See Turn a request into a routine.

Which connection to use ​

ConnectionUse it forWhat you enterCan it change data?
PostgreSQLA PostgreSQL database, on your network or hosted onlineConnection String, for example postgresql://user:password@host:5432/databaseNo. It's read-only.
SQLiteA database file on your computer, such as an app exportDatabase Path, the full location of the fileYes, with your approval
RedisA Redis data storeRedis URL, for example redis://localhost:6379Yes, with your approval

How to connect ​

  1. Open Settings ▸ Connections and stay on the Recommended tab.
  2. Find the database type and click Install.
  3. Review what the connection needs and click Grant All & Continue.
  4. Enter the connection string, file path or URL.
  5. Click Install & Connect.

The card appears on the Installed tab. To check it, open its ⋯ menu and click Test Connection.

What needs your approval ​

  • Questions run without asking. Looking up data, listing tables and running read queries need no approval.
  • Changes ask first. With SQLite and Redis, anything that adds, changes or deletes data shows you what it will do and waits for you. PostgreSQL can't change data at all.

Good to know ​

  • Use a read-only login where you can. Ask whoever runs your database for a user that can only read the tables Pencel needs.
  • Pencel connects from your computer. The database has to be reachable from your machine, for example over your office network or VPN.
  • Your connection details are stored encrypted on your computer. See Data handling.
  • Query results are used to answer you. Rows Pencel reads are sent to your AI model as part of the request, so ask for summaries rather than whole tables of sensitive data.

Disconnect or change what it can do ​

Go to Settings ▸ Connections ▸ Installed and open the card's ⋯ menu:

  • Manage Tools: switch individual actions off everywhere, or choose which run without asking in chats and workflows under Auto-Approval (None, All tools or Custom). Click Save changes. Rooms keep their own approvals.
  • Edit: change the connection string, path or URL.
  • Disconnect stops it for now. Remove deletes it and its saved details.