# Pyunto Diary

> Pyunto Diary is a freemium MCP server for knowledge and memory. Lets Claude read, search and write an encrypted Pyunto diary from your own machine. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, iOS, Android, macOS, Windows
- **Website:** https://pyunto.com
- **Repository:** https://github.com/utagoeinc/pyunto-agent
- **MCP Registry name:** com.pyunto/diary
- **Categories:** knowledge and memory, productivity
- **Listing updated:** 2026-11-16

## About

Pyunto is a private diary app for one person, two people or a group, and its MCP server gives Claude Code or Claude Desktop a seat in that diary. The assistant gets its own Pyunto account and its own identity key, and the person approves it from their phone before it can see anything.

Entries are decrypted in the process running on your computer, not on Pyunto's servers. The server only answers when asked, so it suits reviewing months of notes, summarising a week or drafting an entry from the desk. The package is installed from PyPI as pyunto-agent and speaks over stdio.

The same package also runs a background agent that replies to people in the diary using a persona file you write. The MCP side is the quieter option for people who just want their own assistant to work with their diary. If you use a cloud model, the entries it reads are sent to that provider.

## Features

- **Twelve diary tools:** The website says the server exposes 12 tools for searching, summarising and writing entries.
- **Local decryption:** Diary text is decrypted on the machine running the server, not by Pyunto's servers.
- **Own assistant account:** The assistant signs in with its own account and keys, or with a registered Pyunto account if you provide credentials.
- **Approval on your phone:** A person approves each invitation after seeing who runs the agent.
- **Pairing from chat:** After installing, you ask Claude to pair with your diary to link the account.

## Good for

- Search months of diary entries for a topic or person
- Summarise last week's entries in Claude Code
- Write a new diary entry from the desk without opening the phone app
- Review a shared diary with a partner or group using an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add diary --env PYUNTO_PASSWORD='<PYUNTO_PASSWORD>' -- uvx pyunto-agent
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "diary": {
      "command": "uvx",
      "args": [
        "pyunto-agent"
      ],
      "env": {
        "PYUNTO_PASSWORD": "<PYUNTO_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "diary": {
      "command": "uvx",
      "args": [
        "pyunto-agent"
      ],
      "env": {
        "PYUNTO_PASSWORD": "<PYUNTO_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "diary": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pyunto-agent"
      ],
      "env": {
        "PYUNTO_PASSWORD": "<PYUNTO_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "diary": {
      "command": "uvx",
      "args": [
        "pyunto-agent"
      ],
      "env": {
        "PYUNTO_PASSWORD": "<PYUNTO_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "diary": {
      "command": "uvx",
      "args": [
        "pyunto-agent"
      ],
      "env": {
        "PYUNTO_PASSWORD": "<PYUNTO_PASSWORD>"
      }
    }
  }
}
```

## FAQ

### Where does decryption happen?

Entries are decrypted in the process on your own computer, according to Pyunto, so the servers do not see plaintext.

### How do I install it?

Run claude mcp add pyunto-diary -- uvx pyunto-agent mcp, then ask Claude to pair with your Pyunto diary.

### Does my diary go to an AI provider?

If the assistant uses a cloud model, the entries it reads go to that provider. Pyunto advises telling the other people in the diary.

### What settings are available?

Environment variables set the assistant's display name, an optional Pyunto email and password, and the folder holding its keys.

### Is Pyunto Diary free?

Pyunto Diary has a free plan, with paid plans for more usage or features.

### How do I add Pyunto Diary to Claude Code?

Run this command in your terminal: claude mcp add diary --env PYUNTO_PASSWORD='<PYUNTO_PASSWORD>' -- uvx pyunto-agent

### What are the best alternatives to Pyunto Diary?

The closest alternatives to Pyunto Diary are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/pyunto-diary
