# Woolly MCP server

> Provides a shared, local memory for AI applications using plain Markdown files to store and recall personal facts and project notes.

- Repository: https://github.com/rjcuff/woolly
- Page: https://hostedmcp.org/servers/rjcuff/woolly
- Transport: stdio
- Stars: 12
- License: MIT
- Latest version: 0.13.1

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `OLLAMA_HOST` | no | no |  |

## Tools (8)

- `remember`: Save a durable fact to Woolly, the user's local memory. Personal memory is about the user (preferences, how they work, facts about them) and stays on their computer. Project memory is about the codebase: its stack, conventions, decisions, gotchas and commands. In a repo with .woolly/woolly.md, project memory is shared with the whole team through git, so only save what every teammate's agent should know. Give a stable key for facts that can change; a newer memory with the same key replaces the older one.
- `recall`: Search Woolly for anything relevant to a query: the user's personal memory plus the current project's memory, which may include notes from teammates. Returns current facts, best match first.
- `decide`: Save a decision with the reason and the options that were turned down, so no app suggests them again. Use when the user chooses an approach or rejects one.
- `handoff`: Save a short note on where this session left off: what you were working on, what got done, what was decided and what's next. The next session in any app starts with it. One per project; a new one replaces the last.
- `get_profile`: Get a short summary of everything currently known about the user: facts, preferences and notes. Good to call once at the start of a conversation.
- `list_memories`: List the user's memories, newest first.
- `forget`: Move a memory to the trash by id. Only do this when the user asks. The user can restore it.
- `resolve_conflict`: Make one memory the current fact for its key, replacing the others. Only do this when the user confirms which is right.

## FAQ

### Does Woolly require Ollama to work?

No, Woolly works on its own, but if Ollama is running, Woolly uses it to perform semantic searches by meaning.

### How is my data stored and kept private?

Data is stored locally as plain Markdown files on your computer, ensuring nothing leaves your machine.

### Can I sync my memories across different devices?

Yes, you can use the sync command to keep your devices in step over your own network without using a cloud service.

### How can I use Woolly with my existing AI tools?

You can use the connect command to add Woolly to apps like Claude Desktop, Cursor, and VS Code, or use the proxy for Ollama and OpenAI/Anthropic APIs.
