Skip to content
MCP server

pplog

Official MCP server for pplog: fetch, search and post poems from an AI assistant

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.5.1
Listing updated
today

Similar MCP servers

About pplog

pplog is an open-source MCP server for books and literature. It runs locally on your machine and is started by your AI client.

A deliberately small server from the esa team, offering just three tools against the pplog poem sharing service. An assistant can fetch a poem by ID, search poems with date filters, AND/OR matching and exclusions, and post a new poem on your behalf.

It runs locally over stdio, either as an npm package or a container image, and needs a single PPLOG_ACCESS_TOKEN environment variable. The README is written in Japanese with an English version linked, and the code is MIT licensed. There is no hosted endpoint, so every client starts its own process.

Install

Run in a terminal

claude mcp add pplog --env PPLOG_ACCESS_TOKEN='<PPLOG_ACCESS_TOKEN>' -- npx -y @esaio/pplog-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pplog": {
      "command": "npx",
      "args": [
        "-y",
        "@esaio/pplog-mcp-server"
      ],
      "env": {
        "PPLOG_ACCESS_TOKEN": "<PPLOG_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pplog": {
      "command": "npx",
      "args": [
        "-y",
        "@esaio/pplog-mcp-server"
      ],
      "env": {
        "PPLOG_ACCESS_TOKEN": "<PPLOG_ACCESS_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "pplog": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@esaio/pplog-mcp-server"
      ],
      "env": {
        "PPLOG_ACCESS_TOKEN": "<PPLOG_ACCESS_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "pplog": {
      "command": "npx",
      "args": [
        "-y",
        "@esaio/pplog-mcp-server"
      ],
      "env": {
        "PPLOG_ACCESS_TOKEN": "<PPLOG_ACCESS_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "pplog": {
      "command": "npx",
      "args": [
        "-y",
        "@esaio/pplog-mcp-server"
      ],
      "env": {
        "PPLOG_ACCESS_TOKEN": "<PPLOG_ACCESS_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PPLOG_ACCESS_TOKENAccess token for pplog API authenticationRequired
  • PPLOG_ACCESS_TOKENAccess token for pplog API authenticationRequired

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

get-poem
Get a poem by ID
search-poems
Search poems with date, AND/OR and exclusion filters
create-poem
Post a new poem

What it does

Fetch by ID
Retrieve a single poem by its identifier.
Flexible search
Filter by date, combine terms with AND or OR, and exclude words.
Post poems
Create a new poem from the assistant.
Local stdio server
Runs through docker or npx using one access token.

Good for

  • Ask an assistant to find your earlier poems on a theme
  • Draft and publish a poem from a chat
  • Look up a specific poem by ID
  • Summarise recent posts matching a search

Pricing

Open source

MIT-licensed server; needs a pplog account token

pplog FAQ

What credentials are needed?

A pplog access token, passed as PPLOG_ACCESS_TOKEN.

How do I run it?

With docker or npx from your MCP client configuration.

Who publishes it?

The registry entry calls it the official pplog server, made by the esa team.

Is pplog free?

Yes. pplog is open source, so you can use and self-host it for free.

How do I add pplog to Claude Code?

Run this command in your terminal: claude mcp add pplog --env PPLOG_ACCESS_TOKEN='<PPLOG_ACCESS_TOKEN>' -- npx -y @esaio/pplog-mcp-server

What are the best alternatives to pplog?

The closest alternatives to pplog are Comicvine, Google Books, Poetrydb, Librivox and Literal MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers