@postnesia/mcp

MCP server for the Postnesia memory system. Exposes all memory, journal, and task operations as Model Context Protocol tools over stdio.

Usage

Add to your MCP config (e.g. .claude/settings.json or Claude Desktop):

{
  "mcpServers": {
    "postnesia": {
      "command": "npx",
      "args": ["postnesia-mcp"],
      "env": {
        "DATABASE_URL": "file:///absolute/path/to/memory.db",
        "GEMINI_API_KEY": "your-gemini-api-key",
        "EMBEDDING_MODEL": "gemini-embedding-001",
        "EMBEDDING_DIMENSIONS": "768"
      }
    }
  }
}

DATABASE_URL must be an absolute file:// URL.

Tools

Memory

| Tool | Required | Optional | |---|---|---| | memory_search | query | limit (default: 10) | | memory_add | content, type, importance, tags | contentL1, context, core | | memory_update_core | memoryId, content, contentL1 | — | | memory_recent | — | hours (default: 24), limit (default: 20) | | memory_stats | — | — | | memory_consolidate | — | — | | memory_relationships | memoryId | — |

Memory types: event decision lesson preference person technical

Journal

| Tool | Required | Optional | |---|---|---| | journal_add | date (YYYY-MM-DD), content | learned, keyMoments, mood | | journal_recent | — | days (default: 7) |

Tasks

| Tool | Required | Optional | |---|---|---| | task_create | title | description, session_id, memory_id | | task_update | taskId | status, title, description | | task_list | — | status, session_id, limit (default: 50) |

Task statuses: pending in_progress completed cancelled

Implementation

Built with McpServer from @modelcontextprotocol/sdk and Zod input schemas. All read operations (memory_search, memory_recent) automatically log accesses which feed into the importance decay/boost system.