# pplog

> pplog is an open-source MCP server for books and literature. Official MCP server for pplog: fetch, search and post poems from an AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/esaio/pplog-mcp-server
- **MCP Registry name:** io.github.esaio/pplog
- **Categories:** [books and literature](https://ai-powered.com/categories/books-and-literature)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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.

## Alternatives

- [Comicvine](https://ai-powered.com/mcp/comicvine): Comicvine is a freemium MCP server for books and literature.
- [Google Books](https://ai-powered.com/mcp/google-books): Google Books is a freemium MCP server for books and literature.
- [Poetrydb](https://ai-powered.com/mcp/poetrydb): Poetrydb is a freemium MCP server for books and literature.
- [Librivox](https://ai-powered.com/mcp/librivox): Librivox is a freemium MCP server for books and literature.
- [Literal MCP](https://ai-powered.com/mcp/literal-mcp): Literal MCP is an open-source MCP server for books and literature.
- [ISBN digit shape](https://ai-powered.com/mcp/isbn-digit-shape): ISBN digit shape is an MCP server for developer tools.
- [ISBN URN shape, value discarded](https://ai-powered.com/mcp/isbn-urn-shape-value-discarded): ISBN URN shape, value discarded is an MCP server for developer tools.
- [ISBN-10 digit shape, value discarded](https://ai-powered.com/mcp/isbn-10-digit-shape-value-discarded): ISBN-10 digit shape, value discarded is an MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/pplog
