Jotdown

1# Jotdown - MCP Server for Notion Page Creation and mdBook Generation
2[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/Harry-027/JotDown)](https://archestra.ai/mcp-catalog/harry-027__jotdown)
3 
4Jotdown is a Model Context Protocol (MCP) server that allows large language models (LLMs) to interact with **Notion** and also generate **Markdown Books**. It provides two primary tools for LLMs:
5 
6- 👉  **Notion Integration**: Create or update pages in **Notion** with content generated by the LLM.
7- 👉  **Mdbook Generation**: Generate a **mdbook** from content and manage the structure.
8 
9Jotdown enables LLMs to seamlessly integrate with these systems for various content management and publishing workflows.
10 
11<a href="https://glama.ai/mcp/servers/@Harry-027/JotDown">
12  <img width="380" height="200" src="https://glama.ai/mcp/servers/@Harry-027/JotDown/badge" alt="Jotdown MCP server" />
13</a>
14 
15---
16 
17## Certified by MCPHub
18- 👉 [JotDown](https://mcphub.com/mcp-servers/harry-027/jotdown)
19 
20---
21 
22## Features
23 
24- 🌿 **Notion Integration**: Automatically create or update Notion pages with content generated by the LLM.
25- 🌿 **Mdbook Generation**: Create and manage **mdbooks** directly from content, including generating necessary files like `SUMMARY.md`, `README.md`, and individual chapter markdown files.
26- 🌿 **MCP Support**: Leverages the Model Context Protocol to maintain context over interactions, enabling more intelligent and consistent content creation and updates.
27 
28---
29 
30## Tools Provided by Jotdown
31 
32### 1. **Notion Page Tool**
33   LLMs can use the Notion tool to create or update pages within Notion, allowing them to store structured content like articles or any other type of document directly in Notion.
34 
35   #### Example:
36   - Create a new page in Notion with content that the LLM has generated.
37   - Update an existing Notion page with new information.
38 
39### 2. **mdbook Tool**
40   With the mdbook tool, LLMs can automatically generate markdown books, handling the creation of multiple chapters, managing the structure, and adding a `SUMMARY.md` file for navigation.
41 
42   #### Example:
43   - Generate a new book based on LLM-generated content.
44   - Automatically generate chapters with proper links in `SUMMARY.md`.
45 
46---
47 
48## Installation
49 
50### Prerequisites
51 
52- **Rust**: Make sure you have Rust installed. You can install it from [rust-lang.org](https://www.rust-lang.org/).
53- **Notion API Token**: You will need a Notion API token (`internal integration secret`) to integrate with Notion.
54- **Claude Desktop**: Make sure you have Claude desktop or any other MCP client (Cline, Continue etc) installed and configured with a Notion integration token.
55 
56### Steps to Install
57 
581. Clone the repository:
59 
60    ```bash
61    git clone https://github.com/Harry-027/JotDown
62    cd jotdown
63    ```
64 
652. Install dependencies:
66 
67    ```bash
68    cargo build --release
69    ```
70 
713. Install mdbook cli (required for the book generation to work):
72 
73    ```bash
74    cargo install mdbook
75    ```
76 
774. Notion setup:
78 
79    * Setup Notion connection (internal intergation with access to Notion workspace) & copy the `internal intergration secret` for later use.
80    * Setup a page with title `Jot It Down` in your workspace and share it with your connection. This is required for the integration to work.
81 
825. Set up Claude desktop (or any other MCP client) configuration file (for Notion integration):
83    ```json
84      "mcpServers": {
85            "Jotdown": {
86                "command": "/path_to_repo/Jotdown/target/release/Jotdown",
87                "args": [],
88                "env": {
89                    "NOTION_TOKEN": "your_notion_intergration_token"
90                }
91            }
92      }
93    ```
94 
956. Restart Claude desktop and try it out!
96 
97---
98 
99### Notion Integration Example:
100 
101- To create or update a Notion page, the LLM sends a request to the server specifying the content and page details. The server then interacts with the Notion API to either create a new page or update an existing one.
102 
103### Mdbook Integration Example:
104 
105- LLMs can send structured content to the server to create an entire mdbook, including chapter creation, `README.md`, and `SUMMARY.md` management. The server compiles the content into a complete book.
106 
107---
108 
109## 🧑‍💻 Demo
110 
111### Notion Demo -
112 
113![Demo Notion](./demo/demo_1.gif)
114 
115### MdBook Demo -
116 
117![Demo mdbook](./demo/demo_2.gif)
118 
119### MdBook Screenshots -
120 
121![Demo mdbook screenshot 1](./demo/demo_s_1.png)
122![Demo mdbook screenshot 2](./demo/demo_s_2.png)
123 
124---
125 
126## 🧑‍💻 Contributing
127 
128Feel free to open issues or submit pull requests.
129 
130---
131 
132## 📜 License
133 
134Jotdown is licensed under the **MIT License**. See the LICENSE file for details.
135 
136---
137 
138## 📧 Contact
139 
140For support or inquiries, reach out at [harishmmp@gmail.com](mailto:harishmmp@gmail.com).