How to Automate note Drafts with AI | What the Official API Covers, and Steps Where People Publish

You want to keep your company's or your own note going, but you stall at gathering topics and writing drafts. Even if AI writes the text, you're still left re-pasting it into note's editor. This article is for people who run a note account, and explains how to save a manuscript AI wrote as a note draft so a person can read it before publishing.

It also sorts out the difference between the methods note officially provides and those it doesn't. With note automation, how likely it is to break and who bears responsibility depend on which method you use.

Bottom line

  • The official note API is for companies with a "note pro" business plan contract, used through supported services. It launched on October 8, 2026, and the first supported service is StoryHub Studio. It is not something you can call freely from tools you build yourself
  • Other automation is unofficial, using APIs that note's web screens use internally or browser automation. It may stop without notice when note's specifications change
  • Samurai App's note integration is on the unofficial side too. When you ask in chat, it searches and reads public articles and creates one draft in your own note. It does not publish, update, or delete
  • To create drafts, each person registers their own note cookie (the value of _note_session_v5). Searching and reading public articles works without registering

Three ways to automate note

Official note API Unofficial methods Have AI write only the manuscript
Who can use it Companies with a note pro contract Anyone (at their own risk) Anyone
Saving to note From a supported service to drafts To drafts via internal APIs or screen automation A person pastes into the editor
Provider and how likely it is to break Provided by note and the supported service Stops without notice when note is updated Doesn't depend on note
Cost Fees for note pro and the supported service Depends on the tool Only the AI cost

The official note API is used by companies with a note pro contract, by linking their note account with a supported service such as StoryHub Studio. According to note's announcement, the API itself supports creating, publishing, and updating articles and getting access stats, but which features you can use depends on the service you connect. The first, StoryHub Studio, saves articles as drafts, and publishing is still done on note's screens as before. Only businesses contracted as note pro solution partners can build the note API into their own services.

Unofficial methods include individually developed MCP servers that call note's internal APIs, and scripts that operate a browser automatically. note's robots.txt disallows crawler access to /api/*, and the internal APIs are not promised to outside parties. Read note's terms of use before using them, and decide whether your company may use them.

If you have AI write only the manuscript, you aren't affected by note's specifications. In return, a person pastes the body and redoes the headings every time.

What you can and can't do in Samurai App

Samurai App's note integration falls under unofficial methods in the breakdown above. When you enable it, a dialog asks you to acknowledge that too.

Reading that works without registering (available to everyone once enabled)

  • Search public articles by keyword. Sort by newest, popular, or trending. Up to 20 results per search, with more up to 50 pages
  • Read the body of one article. The body is plain text without formatting, cut off beyond 20,000 characters. For paid articles, only the free part
  • See a creator's profile, article count, and follower count. See a creator's article list and the article list for a hashtag

Actions that use your own cookie

  • Check which note account it's acting as
  • List your own articles, including drafts
  • See the page views, likes, and comment counts of your own articles, for all time, by year, month, or week
  • Create one draft. Titles up to 100 characters, bodies in Markdown up to 50,000 characters

What it can't do

  • Publish, update, delete, or schedule articles, or rewrite a draft it created
  • Upload images or header images, set up paid articles, or add to magazines. Images written in the body become their alt text
  • Like, comment, or follow
  • Read the paid part of paid articles (it won't return it even if you purchased it)
  • Act as someone else's note account. It only acts on the account of the person who registered

Raw HTML written in the Markdown body does not go into the draft. Only http, https, and mailto links are kept.

Using it to gather topics

You can use the same integration for research before creating a draft. This part works without registering a cookie.

  • See what's being read now by hashtag. Ask "List 10 new articles under #remotework and make a table of their titles and like counts," and you get each article's title, author, like and comment counts, and URL
  • Compare the key points of articles on the same theme. Pass the URLs of articles you're interested in and ask "List the key points of these three and the points they don't cover." Only the public parts can be read
  • See how your own articles are doing. If you've registered your cookie, you can see your own articles' numbers by specifying a period and sort order, such as "the top 5 articles by page views this week and this month"

If you decide your angle after seeing the results and then move on to the draft in step 3, you can separate the time spent gathering topics from the time spent writing. When you use the titles or key points of articles you researched in a draft, note in the body which article you took them from.

What you need

  • A Samurai App administrator or manager (the person who enables note)
  • The note account to save drafts to, and a browser signed in to it
  • A policy for the articles: the topics to cover, the writer's standpoint, and what not to write (confidential information, how to handle figures, and so on)

Steps

1. An administrator enables note

Open the "Connectors" screen (/settings/connections), and click "Enable note" in the note section of the "API integrations" tab. A dialog shows an explanation beginning "note has no official API," so read it and click "Enable."

From this point, everyone can search and read public articles from chat.

2. Each user registers their own cookie

Each person who will create drafts registers in this order.

  1. Sign in to note in your browser
  2. Open the developer tools and show note.com's cookies (in Chrome, Application, then Cookies)
  3. Copy the value of _note_session_v5, paste it into the field in the note section, and click "Register note cookie"

It also accepts the value pasted with its name, in the form _note_session_v5=.... Once registered, the section shows which note account it acts as.

With this value, anyone can perform any action on that note account. Samurai App only uses the actions listed above, but don't give the value itself to anyone. Don't paste it into the chat input box either.

3. Ask for a draft in chat

In chat, ask specifically what to research and what to write.

Show me this month's page views for my note articles.
For the same readers as my most-read article, suggest 3 angles I haven't written about yet.

Once you've chosen an angle, ask for the draft.

Write an article of about 2,000 characters using the second angle.
Use 3 headings, and end with a question to the reader.
When it's done, show me the title and body, then save it as a draft in my note. Don't publish it

Before the draft is saved, an approval card appears. Read the title and body, and allow it if there are no problems. Once saved, the URL of the draft's edit screen is returned.

4. Finish it in note's editor and publish

Open the article from the returned URL or from "Drafts" in note. Set the header image, images in the body, hashtags, and the paid section here. Check the facts and figures, add your own experience and thoughts, and then publish.

Things to watch out for

Because it's an unofficial method, it may stop one day. If it keeps failing, note's specifications have most likely changed, so work in note's screens instead.

The cookie stops working if you sign out of note. If it reports that the cookie can't be used, sign in to note again, copy the value, and register it again. If an administrator disables note, everyone's registered cookies are deleted. Articles and drafts in note remain as they are.

If it reports "not sure whether the draft was created," don't repeat the same request. You may end up with two drafts. First ask "List my articles" and check whether it's there.

Don't lean too heavily on other people's articles. Having it read public articles and compare key points is within the bounds of research, but avoid drafts that merely paraphrase someone else's text. If you quote, cite the source.

Don't publish the AI's manuscript as is. It stops at drafts so that a person reads it and publishes it responsibly.

Frequently asked questions

Does note have an official API?

Yes. It launched on October 8, 2026 for companies using note pro. To use it, you need a note pro contract and a contract with a supported service such as StoryHub Studio. As of November 9, 2026, we could not confirm from official sources a public API available to individuals or plans other than note pro.

Can it schedule posts or publish automatically?

Not in Samurai App. Publishing, updating, deleting, and scheduling are operations that can't be undone or are easy to get wrong, so they are left for people to do in note's screens.

Do images or header images go into the draft?

No. Images need to be uploaded to note, and this integration doesn't handle that. If you write image Markdown in the body, only the alt text remains. Writing where an image goes in the body, such as "(figure here)," and inserting it in note's editor reduces rework.

Can I share the article in Slack or elsewhere before making it a draft?

You can create the manuscript in chat, show it to others, and then ask "Make a draft with this content." The steps for doing the same "AI up to the draft, people send it" approach in Gmail are explained in How to draft replies to inquiry emails with AI.

Can I use it with the company's official note?

Yes, but the cookie is treated as belonging to the person who registered it. If you register with the company account, drafts can only be created from conversations of the person who registered that cookie. Decide who registers with which account before you start.

Sources

Confirmed against the announcements from note inc. and StoryHub Inc. and note.com's robots.txt as of November 9, 2026.

Related featureConnect business tools to AI over MCPSamurai App connects your business tools to AI over MCP. Operate accounting and HR SaaS from chat within each person's own permissions, call the agent from Slack or Teams, and use it from outside AI clients over MCP.

More automation examples

    Back to How-to articles

    Everyday work comes together, connects, and becomes the company's strength.

    Contact usOpen Samurai App

    See the demoContact us