Notion Workflow MCP

Instructions

Implementation Reference

• tools/notes.py:109-122 (handler)

  The handler function that executes the append_note tool logic.

  def append_note(note_id: str, content: str) -> dict:
      """
      向已有笔记追加内容（追加到页面 body 末尾）。
  
      Args:
          note_id: 笔记 ID
          content: 要追加的文本内容
  
      Returns:
          更新后的笔记元信息（不含完整 body）
      """
      client = get_client()
      client.append_note_content(note_id, content)
      return client.get_note(note_id).model_dump()

• notion/client.py:524-529 (helper)

  The helper method that interacts with the Notion API to perform the actual block append operation.

  def append_note_content(self, note_id: str, content: str) -> None:
      """Append a paragraph block to a note page body."""
      self.client.blocks.children.append(
          block_id=note_id,
          children=[self._text_block(content)],
      )

• server.py:51-51 (registration)

  Registration of the append_note function as an MCP tool.

  mcp.tool(append_note)