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.
- Sign in to note in your browser
- Open the developer tools and show note.com's cookies (in Chrome, Application, then Cookies)
- 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
- note launches the "note API" for businesses (note inc., October 8, 2026)
- StoryHub Studio launches a feature to send articles created in it directly to note (StoryHub Inc.)
- robots.txt for note.com
- Connecting to external services (Samurai App guide)
- How to connect each service through API integrations (Samurai App guide)
Confirmed against the announcements from note inc. and StoryHub Inc. and note.com's robots.txt as of November 9, 2026.