willow-mcp
willow-mcp is an agent-neutral MCP server providing persistent memory and task execution through three storage backends: a local SQLite key/value store, a Postgres knowledge base, and a sandboxed task queue.
SQLite Store (SOIL) Operations:
store_put— Write a JSON record to a named collectionstore_get— Retrieve a specific record by IDstore_list— List all records within a collectionstore_update— Modify an existing recordstore_search— Multi-keyword AND search within a collectionstore_search_all— Search across all collections simultaneouslystore_delete— Soft-delete a record by ID
Postgres Knowledge Base Operations:
knowledge_ingest— Add a knowledge atom (with optional tags, domain, and source)knowledge_search— Multi-keyword search, optionally filtered by domain
Task Queue (Kart) Operations:
task_submit— Submit a shell command or script to a sandboxed execution queuetask_status— Check the status of a submitted task by IDtask_list— List all pending tasks
Authorization: Every tool call is gated via SAP/1.0 filesystem-based identity checking (open mode if openclaw-sap-gate is not installed). Compatible with Claude Code, Claude Desktop, Cursor, or any stdio MCP client.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@willow-mcpstore the user preferences for app 'notes' with key 'theme' as 'dark'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
willow-mcp
Agent-neutral MCP server with persistent memory and task execution. Works with any MCP client: Claude Code, Claude Desktop, Cursor, or any custom agent that speaks stdio MCP.
Three storage backends in one server:
SOIL store — SQLite-backed local key/value store with full-text search and soft delete
Postgres knowledge base — multi-keyword searchable knowledge graph
Kart task queue — sandboxed task executor for shell commands and scripts
Every tool call is authorized via SAP/1.0 — a filesystem-based identity gate with no ACL database.
Install
pip install willow-mcpRequires Python 3.11+. Postgres is optional — SOIL store works standalone.
Tools
Tool | Description |
| Write record (JSON object) to SQLite store |
| Read record by |
| List all records in a collection |
| Update an existing record |
| Multi-keyword AND search in a collection |
| Soft-delete a record by |
| Search across all collections |
| Add to Postgres knowledge base |
| Multi-keyword search in Postgres knowledge base |
| Submit task to Kart queue |
| Check task status |
| List pending tasks |
Every tool requires an app_id param. Authorization is checked via SAP/1.0.
MCP config
{
"mcpServers": {
"willow": {
"command": "python3",
"args": ["-m", "willow_mcp"]
}
}
}You can also run the full willow-1.9 server directly — the tool API is identical, apps work against both transparently.
Configuration
Env var | Default | Description |
|
| Postgres database name |
|
| Postgres user (Unix socket auth) |
|
| SQLite store directory — set to willow-1.7's store root to share data |
|
| Default app_id if not passed per-call |
|
| SAFE folder root |
| (empty) | Pinned GPG fingerprint |
Authorization
Uses openclaw-sap-gate (SAP/1.0). If openclaw-sap-gate is not installed, all calls are permitted (open mode).
License
MIT — Sean Campbell 2026
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/rudi193-cmd/willow-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server