Skip to main content
공개 노트

Tilnote MCP Tool Reference

Views 6약 4분
Summary

Once the connector is added, your assistant has eighteen tools available. You never call them by name — you describe what you want and the assistant picks. Still, knowing what exists helps you ask for the right thing, and knowing which ones are destructive tells you when to read carefully before saying yes.

Reading

ToolWhat it does
list_notesRecent notes with title, excerpt and URL
search_notesFull-text search across your notes
get_noteOne note's full content
get_note_blocksThe same note split into addressable blocks, plus a revision marker
get_note_statsViews, likes and purchases — one post or a blog-wide summary
list_booksYour books with page counts
get_bookOne book with its table of contents

None of these change anything, so an assistant can call them freely while figuring out what you meant.

Writing

ToolWhat it does
create_noteNew private draft
update_noteReplace a note's body wholesale
edit_noteChange specific blocks, leaving the rest byte-identical
append_to_noteAdd to the end
create_bookNew book
add_page_to_bookPut a note in a book
remove_page_from_bookTake it back out — does not delete the note

update_note and edit_note are both overwrites and are marked destructive, so your client may ask before running them. That is intentional: both can lose text you wrote.

Publishing

ToolWhat it does
publish_notePut a note on your public blog, or create and publish in one call
unpublish_noteFlip it back to private, content intact
delete_noteRemove a note entirely — requires explicit confirmation

These need a separate permission from ordinary writing, because putting something on the public internet is a different decision from saving a draft.

Shortcuts

The connector also ships four prompt templates, which show up as slash commands or shortcuts depending on your client:

  • til — turn what you just worked on into a note, optionally published

  • blog_post — write and publish a full post on a topic

  • polish_and_publish — tidy an existing draft, then publish it

  • blog_report — summarize how recent posts are doing and suggest what to write next

These exist because eighteen tools is a lot to choose from. Starting from a template is usually faster than describing the whole workflow.

One habit worth forming

Tell the assistant to write straight into the tool call rather than printing the draft into the chat first. Otherwise the same article gets generated twice and you wait roughly twice as long for no benefit.

이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.

틸노트는 사용자가 AI를 활용해 노트를 쉽게 작성하거나 편집할 수 있는 서비스입니다.

AI 스퀘어 단톡방에 함께해요

AI 활용과 틸노트 사용 팁을 나누는 오픈채팅방입니다. 입장 비밀번호는 tilnote입니다.

참여하기