I write my posts in Markdown with agents in Cursor. Then I want the same page in Notion so I can share it with the team and they can comment.
I did this because hosted Notion MCP did not support uploads. They’ve added that recently (notion-create-file-upload), but it still has to be done one file at a time. If you want to sync a blog post with multiple images, your agent still has to call the tool once per image. That’s a waste of time and tokens.
One image: just use the MCP. More than one: the script is faster.
Ask your agent to copy the script locally and run it when you need it. Wrap it as a skill if you want.
https://gist.github.com/sanjeed5/57760c6093d3d774d70972dfbfd4c0ff
For the agent: share the Notion page with your integration, set NOTION_PAT in the environment, then:
python3 notion_md_sync.py push PAGE_URL_OR_ID post.md --apply
That’s it.