MCP Server

Palinode MCP Server

Name: Palinode MCP Server
Author: io.github.phasespace-labs

io.github.phasespace-labs/palinode

Repository Registry

What is the Palinode MCP server?

Git-versioned markdown memory for AI agents: save, search, compact, lint, and audit.

How to install Palinode

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

PALINODE_DIR
required
Path to the markdown-memory directory (e.g. ~/.palinode). Created if missing.
PALINODE_API_HOST
Host where the back-end palinode-api process is reachable
PALINODE_API_PORT
Port for palinode-api
PALINODE_API_TOKEN
secret
Optional bearer token enforced on every palinode-api request other than /health. Required when PALINODE_API_BIND_INTENT=public. Generate with: python -c 'import secrets; print(secrets.token_urlsafe(32))'.
PALINODE_API_TOKEN_FILE
secret
Path to a file containing the bearer token (alternative to PALINODE_API_TOKEN; for docker-secrets style deployments)
PALINODE_MCP_HTTP_HOST
Bind host for the MCP HTTP server. Defaults to loopback; set to 0.0.0.0 only with intentional network exposure (paired with PALINODE_API_BIND_INTENT=public on the back-end).
PALINODE_MCP_HTTP_PORT
Port for the MCP HTTP server

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "palinode": {
      "command": "uvx",
      "args": [
        "palinode",
        "--from",
        "palinode",
        "palinode-mcp"
      ],
      "env": {
        "PALINODE_DIR": "<YOUR_PALINODE_DIR>",
        "PALINODE_API_HOST": "<YOUR_PALINODE_API_HOST>",
        "PALINODE_API_PORT": "<YOUR_PALINODE_API_PORT>",
        "PALINODE_API_TOKEN": "<YOUR_PALINODE_API_TOKEN>",
        "PALINODE_API_TOKEN_FILE": "<YOUR_PALINODE_API_TOKEN_FILE>",
        "PALINODE_MCP_HTTP_HOST": "<YOUR_PALINODE_MCP_HTTP_HOST>",
        "PALINODE_MCP_HTTP_PORT": "<YOUR_PALINODE_MCP_HTTP_PORT>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "palinode": {
      "command": "uvx",
      "args": [
        "palinode",
        "--from",
        "palinode",
        "palinode-mcp"
      ],
      "env": {
        "PALINODE_DIR": "<YOUR_PALINODE_DIR>",
        "PALINODE_API_HOST": "<YOUR_PALINODE_API_HOST>",
        "PALINODE_API_PORT": "<YOUR_PALINODE_API_PORT>",
        "PALINODE_API_TOKEN": "<YOUR_PALINODE_API_TOKEN>",
        "PALINODE_API_TOKEN_FILE": "<YOUR_PALINODE_API_TOKEN_FILE>",
        "PALINODE_MCP_HTTP_HOST": "<YOUR_PALINODE_MCP_HTTP_HOST>",
        "PALINODE_MCP_HTTP_PORT": "<YOUR_PALINODE_MCP_HTTP_PORT>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "palinode": {
      "command": "uvx",
      "args": [
        "palinode",
        "--from",
        "palinode",
        "palinode-mcp"
      ],
      "env": {
        "PALINODE_DIR": "<YOUR_PALINODE_DIR>",
        "PALINODE_API_HOST": "<YOUR_PALINODE_API_HOST>",
        "PALINODE_API_PORT": "<YOUR_PALINODE_API_PORT>",
        "PALINODE_API_TOKEN": "<YOUR_PALINODE_API_TOKEN>",
        "PALINODE_API_TOKEN_FILE": "<YOUR_PALINODE_API_TOKEN_FILE>",
        "PALINODE_MCP_HTTP_HOST": "<YOUR_PALINODE_MCP_HTTP_HOST>",
        "PALINODE_MCP_HTTP_PORT": "<YOUR_PALINODE_MCP_HTTP_PORT>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "palinode": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "palinode",
        "--from",
        "palinode",
        "palinode-mcp"
      ],
      "env": {
        "PALINODE_DIR": "<YOUR_PALINODE_DIR>",
        "PALINODE_API_HOST": "<YOUR_PALINODE_API_HOST>",
        "PALINODE_API_PORT": "<YOUR_PALINODE_API_PORT>",
        "PALINODE_API_TOKEN": "<YOUR_PALINODE_API_TOKEN>",
        "PALINODE_API_TOKEN_FILE": "<YOUR_PALINODE_API_TOKEN_FILE>",
        "PALINODE_MCP_HTTP_HOST": "<YOUR_PALINODE_MCP_HTTP_HOST>",
        "PALINODE_MCP_HTTP_PORT": "<YOUR_PALINODE_MCP_HTTP_PORT>"
      }
    }
  }
}

Claude Code

claude mcp add palinode --env PALINODE_DIR=<YOUR_PALINODE_DIR> --env PALINODE_API_HOST=<YOUR_PALINODE_API_HOST> --env PALINODE_API_PORT=<YOUR_PALINODE_API_PORT> --env PALINODE_API_TOKEN=<YOUR_PALINODE_API_TOKEN> --env PALINODE_API_TOKEN_FILE=<YOUR_PALINODE_API_TOKEN_FILE> --env PALINODE_MCP_HTTP_HOST=<YOUR_PALINODE_MCP_HTTP_HOST> --env PALINODE_MCP_HTTP_PORT=<YOUR_PALINODE_MCP_HTTP_PORT> -- uvx palinode --from palinode palinode-mcp