Prompt Book Server

An MCP server that connects to Notion databases containing AI prompts, allowing you to manage, search, and retrieve prompts efficiently across multiple prompt collections.

What does prompt book server do?

The Prompt Book Server is a powerful tool that helps you organize and access your AI prompts stored in Notion databases. It provides the following key capabilities:

• Multiple Prompt Books: Manage multiple collections of prompts (prompt books) with different Notion databases
• Prompt Discovery: Search, filter, and browse prompts by title, type, or tags
• Prompt Retrieval: Quickly access the full content of any prompt
• Prompt Management: Add new prompts, update existing ones, and copy prompts between books
• Database Creation: Create new prompt databases with the proper schema directly in Notion

The server acts as a bridge between your AI tools and your Notion-based prompt collections, making it easy to maintain a centralized library of prompts that can be accessed from various coding and AI tools.

All the tools

Configuration Management Tools

| Tool Name | Description | |-----------|-------------| | list_prompt_books | Lists all configured prompt books | | create_prompt_book_config | Adds a new prompt book configuration | | remove_prompt_book_config | Removes a prompt book configuration | | activate_prompt_book | Sets a prompt book as active | | rename_prompt_book | Renames a prompt book configuration | | create_prompt_database | Creates a new prompt database in Notion and adds it to the configuration | | copy_prompt | Copies a prompt from one book to another |

Prompt Management Tools

| Tool Name | Description | |-----------|-------------| | list_prompts | Lists all prompts in the active database | | search_prompts_by_title | Searches prompts by title | | get_prompts_by_tag | Gets prompts filtered by a specific tag | | get_prompts_by_type | Gets prompts filtered by a specific type | | read_prompt | Reads the full content of a specific prompt | | list_all_types | Lists all unique prompt types in the database | | list_all_tags | Lists all unique tags used in the database | | add_prompt | Adds a new prompt to the database | | update_prompt | Updates an existing prompt in the database |

How to configure it in my coding tools (or non coding tools)?

Add to MCP Configuration

Add the server to your MCP configuration file. The location depends on your MCP client:

Path to the MCP config

1. cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
2. roo_code: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
3. windsurf: ~/.codeium/windsurf/mcp_config.json
4. claude: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the following configuration:

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

Example prompts to work with it

Here are some example prompts you can use to interact with the Prompt Book Server:

Listing and Searching Prompts

List all my prompt books.

Show me all prompts in the prompt book.

Search for prompts related to "GPUImage" in my prompt book.

Show me all prompts with the tag "PicCollage".

List all prompts of type "Coding"

What types of prompts are available in my prompt book?

Reading Prompts

Get the prompt about idea evaluation from the prompt book.
Follow the instructions in it and then verify the following idea for me:
describe your idea

Managing Prompt Books

Activate the engineering prompt book.

Copy the GPUImage porting prompt from my private book to the engineering book.

Adding and Updating Prompts

Add a new prompt titled "React Component Generator" with type "Coding" and tags ["React", "Frontend"].

The prompt should include ....
......
.....

Update the "React Component Generator" prompt to include TypeScript support.

Please create a very detailed prompt to instruct LLM agents to convert Android XML UI implementations into Compose UI elements or screens. Put that prompt to the prompt book.

How to add a new prompt book?

You have two main options for adding a new prompt book:

Option 1: Connect to an Existing Notion Database

If you already have a Notion database with prompts, you can connect it directly:

1. Get your Notion API token from https://www.notion.so/my-integrations
2. Share your Notion database with your integration
3. Get the database ID from the URL (it's the part after the workspace name and before the question mark)
4. Use the create_prompt_book_config tool:

Add a new prompt book with the following details:
- Name: "My Team Prompts"
- Notion token: "secret_abc123..."
- Notion database ID: "1a748be2b63280988d9bc5f89918431d"

Option 2: Create a New Notion Database

If you want to create a fresh prompt database with the correct schema:

1. Get your Notion API token from https://www.notion.so/my-integrations
2. Find the ID of a Notion page where you want to create the database
3. Use the create_prompt_database tool:

Create a new prompt database with these details:
- Name: "My New Prompt Book"
- Notion token: "secret_abc123..."
- Page ID: "1a748be2b63280988d9bc5f89918431d"
- Activate: true

This will create a new database with the proper schema (Name, Type, Tags) and add it to your configuration.

Notion Database Requirements

For optimal functionality, your Notion database should have the following properties:

• Name (title): The title of the prompt
• Type (select): The category of the prompt (e.g., "Coding", "Image Generation")
• Tags (multi-select): Tags for organizing and filtering prompts

The prompt content itself is stored in the page body as blocks of text.

Development

Prerequisites

• Node.js 16+
• TypeScript
• Notion API token

Setup

1. Clone the repository
2. Install dependencies: npm install
3. Build the project: npm run build
4. Run the server: npm start

Configuration File Structure

The configuration file at ~/.mcp_config/prompt_book.json has the following structure:

{
  "promptBooks": [
    {
      "id": "uuid-string",
      "name": "My Prompt Book",
      "notion_token": "your-notion-api-token",
      "notion_database_id": "your-notion-database-id"
    }
  ],
  "activePromptBookId": "uuid-string"
}

Environment Variable Configuration (DEFAULT_BOOKS)

You can provide a default configuration using the DEFAULT_BOOKS environment variable. This is particularly useful for:

• Setting up prompt books automatically in deployment environments
• Providing default configurations for team members
• Pre-populating the server with prompt book configurations

The DEFAULT_BOOKS environment variable should contain a valid JSON string matching the configuration file structure above.

Important Notes:

• The DEFAULT_BOOKS environment variable is only used when the configuration file ~/.mcp_config/prompt_book.json doesn't exist yet
• If the configuration file already exists, the environment variable is ignored
• If the JSON in DEFAULT_BOOKS is invalid or doesn't match the expected structure, it will be ignored and an empty configuration will be created instead

Example usage:

# Set the environment variable
export DEFAULT_BOOKS='{"promptBooks":[{"id":"12345678-1234-1234-1234-123456789012","name":"Default Prompt Book","notion_token":"secret_abc123...","notion_database_id":"1a748be2b63280988d9bc5f89918431d"}],"activePromptBookId":"12345678-1234-1234-1234-123456789012"}'

# Run the server - it will use the DEFAULT_BOOKS configuration if no config file exists
npx @piccollage/prompt-book-mcp-server

This feature is especially useful when deploying the server in containerized environments or when you want to provide team members with a pre-configured setup.