Pellet can open a small connection on your computer so an AI assistant or a script can work with your notes, tasks and calendar. The connection speaks MCP, a standard that several AI tools support, so you pick the tool. It stays off until you turn it on. Pellet’s help says nothing gets sent to Pellet or to anyone else.
Things you might ask it to do
Pellet’s help gives requests like these:
- “find every note mentioning the Monterrey site and summarize them”
- “make a task for each unticked checkbox in this week’s dailies”
- “what’s overdue that I haven’t skipped?”
The connection offers around fifty operations. They include tasks, notes, search inside note bodies, boards and checklists, your calendar, daily notes, templates, attachments, canvases, the archive and the trash. If an agent completes a repeating task, Pellet handles the repeat and doesn’t just tick the box.
Turn it on
Open Settings → AI & MCP. Pellet shows an address to give your tool, a command for tools that want to launch one instead, and an optional token. A Status line sits underneath. If it says Not running, it tells you why, and the usual cause is another app holding the port. Change the port number and it comes up. Pellet uses port 27124 by default because the Obsidian task-manager plugin listens on 27123.
You need a Pellet license once the desktop trial ends. Without a key, the server doesn’t listen and the Status line reads License required. Pellet keeps your port, token and switches, and the server comes back as soon as you enter a key, with no relaunch.
Start with tight limits
Three switches in Settings → AI & MCP decide how much the assistant can touch:
- Read-only: the agent can read everything and change nothing. Pellet hides the writing operations from it, so it won’t waste your time planning around them.
- Folder allowlist: you name the folders it may use. Notes outside those folders don’t appear in its searches or listings.
- Per-operation switches: you turn off anything you don’t want it doing, such as deleting notes or touching your calendar.
All three start off, so a new connection can read and write across the whole vault until you change them. I’d turn on Read-only first and see how the assistant handles your vault. Once you let it write, keep a folder allowlist and leave deletes and calendar changes off.
The safety nets
- The connection listens only to your own computer. Nothing on the internet can reach it, with or without the token.
- If you require a token, other software on your machine can’t use the connection by accident. Pellet keeps the token in your operating system’s keychain instead of your vault.
- Switching it off closes the connection at once.
- Deletes go to Pellet’s trash, and file history keeps the earlier version if an agent overwrites a note.
It’s desktop only: macOS, Windows and Linux. The iPhone, iPad and Android apps don’t have it. On iOS, the system doesn’t let an app listen for connections.
You’ll find the full list of operations on Pellet’s help page: Letting an AI agent use your vault.
Disclosure: I’m the creator of Pellet. This post follows Pellet’s help page on letting an AI agent use your vault.
