prompt-book

The Prompt Book Server is a centralized MCP server that bridges Notion-based prompt collections with your development or AI tooling workflow. It lets you organize multiple prompt books (Notion databases), discover prompts via titles, tags, or types, and retrieve or modify prompts directly from your coding tools or assistants. With the provided tools, you can list, search, read, add, update, or copy prompts across books, and you can create new Notion databases with the required schema (Name, Type, Tags) to expand your prompt library. This makes it easy to keep a consistent, searchable repository of prompts that can be accessed from your IDEs, notebooks, or AI agents. To use it, configure the MCP client to point at the prompt-book MCP server, then interact with the available commands to manage and query your prompt books and prompts. The server acts as a lightweight gateway that translates your tool requests into Notion operations behind the scenes.

Key capabilities include:

• Managing multiple prompt books across different Notion databases
• Discovering prompts through search by title, filtering by type, or filtering by tags
• Reading full prompt content and copying prompts between books
• Creating new databases with the proper schema directly in Notion
• A set of management commands to add, remove, or activate prompt books, as well as to manage the prompts themselves Use cases range from quickly browsing a library of prompts while coding, to integrating with AI pipelines that need ready-to-use prompts for various tasks.

Prerequisites:

• Node.js 16+ (for the MCP server approach via npx)
• Internet access to fetch the MCP server package from npm
• Notion API token with access to your Notion databases

Installation steps:

1. Prereq check

node -v
npm -v

2. Run the server using npx (no local installation required):

npx -y @piccollage/prompt-book-mcp-server

3. If you prefer a local installation (optional):

npm install -g @piccollage/prompt-book-mcp-server
npx @piccollage/prompt-book-mcp-server

4. Create or edit your MCP configuration to include the server (example path varies by client):

// Example entry
{
  "mcpServers": {
    "prompt-book-server": {
      "command": "npx",
      "args": ["-y", "@piccollage/prompt-book-mcp-server"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

5. Start the MCP server and verify it appears in your MCP client configuration. Ensure your Notion API token and database IDs are correctly configured when you add prompt books.

Note: If you plan to run in a deployment environment, you can also use the DEFAULT_BOOKS environment variable to pre-populate a default configuration, as described in the README.

Notion integration requires a valid Notion API token and proper sharing permissions for the databases you want to manage. Keep your Notion token secure and avoid embedding it directly in client-side configurations. When adding new prompt books or databases, ensure the Notion schema includes Name (title), Type (select), and Tags (multi-select) to support the server's discovery and filtering features. If prompts do not appear or searches return empty results, verify that the active prompt book is set and that the Notion database has the required properties. For large collections, consider indexing strategies or pagination in your client tools to avoid long response times. The server supports copying prompts between books, which can be useful for sharing or templating prompts across different teams or projects.