pplog
Official MCP server for pplog: fetch, search and post poems from an AI assistant
- 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-serverAdd 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 authenticationRequiredPPLOG_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.
