When developing DeepSeek Harness agents, handling content distribution is a common requirement. Directly calling the Notion API requires writing complex JSON construction logic and handling API token storage and refresh. This plugin uses an MCP server to directly convert Markdown text into the JSON format accepted by the Notion API, simplifying the integration process.

Plugin Positioning

This is an MCP server plugin maintained by xby-skill, used to convert Markdown content into a Notion API-compatible format. It is primarily aimed at content management and development integration scenarios, helping reduce the code developers need to write for conversion logic.

Core Features

The plugin provides two core tools:

  • set_xby_apikey: Sets the API key in chat. The key is automatically persisted and remains valid after restarting the DSH process.
  • markdown_to_notion: Converts Markdown text content into the JSON structure required for Notion page content.

Installation and Enablement

Run the following command in the terminal to install the plugin:

dsh plugin --profile web add github:xby_skill/xby-markdown-to-notion

After installation, restart the DSH process. The plugin will be loaded and ready to use.

Typical Usage

Before using this plugin, you must first obtain an API key.

  1. Obtain the key: Go to the Xiao Ben Yang official website to register and obtain an API key.
  2. Set the key: Invoke the set_xby_apikey tool in the conversation and provide your API key.
  3. Perform the conversion: Invoke the markdown_to_notion tool with the prepared Markdown text as the parameter.

Applicable Scenarios and Notes

This plugin is suitable for developers or content creators who need to quickly synchronize Markdown documents to a Notion system.

Notes:
* The plugin runs with the permissions of the current DSH process. Before installing, it is recommended to check the plugin’s source repository (GitHub) to confirm that its behavior meets your expectations.
* You must complete registration on the Xiao Ben Yang official website and obtain an API key before using it.

This plugin provides lightweight conversion capabilities and lowers the barrier to integrating Notion. For more details, refer to the plugin directory or the GitHub repository.