home / mcp / prompt book mcp server

Prompt Book MCP Server

Exposes Notion-based prompt books to MCP clients for discovering, reading, and managing prompts

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "cardinalblue-prompt-book-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@piccollage/prompt-book-mcp-server"
      ]
    }
  }
}

The Prompt Book MCP Server connects your AI prompts stored in Notion databases and exposes a practical interface you can use from your coding tools or local utilities. It lets you organize multiple prompt books, discover prompts quickly, retrieve full prompt content, and move prompts between books, all while keeping the data in Notion. This makes it easy to maintain a centralized, searchable library of prompts that various tools can access.

How to use

You interact with the Prompt Book MCP Server through your MCP client or your development environment. First, connect the server as an MCP endpoint, then perform common tasks such as listing your prompt books, selecting an active book, searching by title or tag, and reading or updating prompts. You can copy prompts between books to reuse ideas across teams, and you can create new Notion databases with the proper schema when you need another collection.

How to install

Prerequisites: Node.js 16+ and a Notion API token. You will also need an MCP client to connect to the server.

Step 1: Prepare your environment and ensure Node.js is installed.

Step 2: Install and run the MCP server using the provided command.

Additional setup and usage notes

Configure the server in your MCP client by adding a new MCP server entry. The configuration snippet below shows how to register the prompt book MCP server so your tools can discover and use it.

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

Using the server with your MCP client

After adding the server configuration, you can list prompt books, activate a book, copy prompts between books, and manage prompts through your MCP client.

Configuration and management

You manage prompt books and prompts with dedicated tools. You can create new prompt books, connect Notion databases, and curate the prompt collection for your team.

Security and data considerations

The server relies on your Notion integration token to access databases. Keep tokens secure and only share access with trusted teammates. When connecting new Notion databases, ensure proper sharing with your integration.

Available tools

list_prompt_books

Lists all configured prompt books to show you which collections you have set up.

create_prompt_book_config

Adds a new prompt book configuration so you can connect an additional Notion database.

remove_prompt_book_config

Removes a prompt book configuration from your MCP setup.

activate_prompt_book

Sets a specific prompt book as the active collection for quick access.

rename_prompt_book

Renames an existing prompt book configuration to help you stay organized.

create_prompt_database

Creates a new Notion database with the required schema and adds it to your configuration.

copy_prompt

Copies a prompt from one book to another for reuse across collections.

list_prompts

Lists all prompts in the active prompt book database.

search_prompts_by_title

Searches prompts by their title to quickly locate items.

get_prompts_by_tag

Filters prompts by a specific tag for targeted discovery.

get_prompts_by_type

Filters prompts by their type to organize your library.

read_prompt

Reads the full content of a selected prompt.

list_all_types

Lists all unique prompt types currently in use.

list_all_tags

Lists all unique tags used across prompts.

add_prompt

Adds a new prompt to the active database with the specified title, type, and tags.

update_prompt

Updates an existing prompt’s content, type, or tags in the database.