Postgram MCP Server

Self-hosted memory for AI agents with hybrid search, knowledge graphs, tasks, and document sync.

Remote serverstreamable-httpTypeScript

What is the Postgram MCP Server?

Self-hosted memory for AI agents with hybrid search, knowledge graphs, tasks, and document sync.

What you get

A self-hosted productivity and knowledge backend for humans and AI agents.

  • One private corpus across tools. — Give different agents and devices access
  • Inspectable source data. — Store typed entities instead of opaque chat
  • Search before graph expansion. — Hybrid retrieval finds relevant entities;
  • Working context is not durable memory. — Session context has its own scope
  • Operator control. — Choose where PostgreSQL runs, which embedding and

Configuration and credentials

  • Docker and Docker Compose for the recommended deployment - Node.js 22+ for the pgm CLI or local development - a reachable OpenAI or Ollama embedding provider for enrichment and search Optional: - OpenAI API key (for OpenAI embeddings or extraction) - Anthropic API key (for LLM extraction) - Ollama (for local embeddings or LLM extraction) - gpg (for encrypted CLI backups)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Postgram MCP Server

{
  "mcpServers": {
    "postgram": {
      "command": "npx",
      "args": ["-y", "@ivotoby/postgram-cli"],
      "env": {
        "PGM_API_URL": "your-value",
        "PGM_API_KEY": "your-value",
        "OPENAI_API_KEY": "your-value",
        "ANTHROPIC_API_KEY": "your-value",
        "OLLAMA_BASE_URL": "your-value",
        "ADMIN_MFA_SECRET_KEY": "your-value",
        "ADMIN_SETTINGS_ENCRYPTION_KEY": "your-value",
        "POSTGRES_HOST": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Docker and Docker Compose for the recommended deployment - Node.js 22+ for the pgm CLI or local development - a reachable OpenAI or Ollama embedding provider for enrichment and search Optional: - OpenAI API key (for OpenAI embeddings or extraction) - Anthropic API key (for LLM extraction) - Ollama (for local embeddings or LLM extraction) - gpg (for encrypted CLI backups)
VariableDescriptionRequired
PGM_API_URLEndpoint or connection string the server talks to.Yes
PGM_API_KEYCredential the server authenticates with.Yes
OPENAI_API_KEYCredential the server authenticates with.Yes
ANTHROPIC_API_KEYCredential the server authenticates with.Yes
OLLAMA_BASE_URLEndpoint or connection string the server talks to.Yes
ADMIN_MFA_SECRET_KEYCredential the server authenticates with.Yes
ADMIN_SETTINGS_ENCRYPTION_KEYCredential the server authenticates with.Yes
POSTGRES_HOSTEndpoint or connection string the server talks to.Optional

Example prompts to try

  • “Use Postgram to Server.”

Frequently asked questions

Self-hosted memory for AI agents with hybrid search, knowledge graphs, tasks, and document sync. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.