Skip to content
MCP server

Pyunto Diary

Lets Claude read, search and write an encrypted Pyunto diary from your own machine

Runs locallyStatus and history
Pricing
Freemium
Platforms
CLI, iOS, Android
Runs
Locally
Version
0.3.0
Listing updated
1 day ago

About Pyunto Diary

Pyunto Diary is a freemium MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • PYUNTO_AGENT_NAMEDisplay name of this assistant's own Pyunto account, shown to the people in the diary
  • PYUNTO_EMAILOptional: sign in as a registered Pyunto account instead of creating the assistant's own
  • PYUNTO_PASSWORDPassword for PYUNTO_EMAIL
  • PYUNTO_AGENT_DIRWhere the account's identity key, space keys and decrypted attachments are kept

What it does

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

Pricing

Freemium

Diary free, including one agent or robot per account; Pyunto+ subscription per space adds more (price not published)

Prices change. Check pyunto.com before you buy.

Pyunto Diary 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 to Pyunto Diary

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools