An MCP (Model Context Protocol) server that lets AI assistants create, read, search, and update notes on Tilnote. Works with Claude Code, Claude Desktop, Google Antigravity, and OpenAI Codex CLI.

Tools

Notes

Tool	Description
create_note	Create a new markdown note (saved as draft)
get_note	Get the full content of a note by page ID
list_notes	List your recent notes with excerpts
search_notes	Search notes by keyword
update_note	Update the title or content of an existing note

Books

Tool	Description
create_book	Create a new book
list_books	List your books with title, page count, and status
get_book	Get book details including its list of pages
add_page_to_book	Add an existing note to a book
remove_page_from_book	Remove a note from a book

Prerequisites

• Node.js 18+ — https://nodejs.org (includes npx)

Setup

1. Get your API key

Go to https://tilnote.io/tilnote-api to generate your API key.

2. Configure your MCP client

Claude Code (.mcp.json)

{
  "mcpServers": {
    "tilnote": {
      "command": "npx",
      "args": ["-y", "tilnote-mcp-server"],
      "env": {
        "TILNOTE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop

OS	Config file location
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tilnote": {
      "command": "npx",
      "args": ["-y", "tilnote-mcp-server"],
      "env": {
        "TILNOTE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Google Antigravity

Open: Manage MCP Servers → View raw config → ~/.gemini/antigravity/mcp_config.json

{
  "mcpServers": {
    "tilnote": {
      "command": "npx",
      "args": ["-y", "tilnote-mcp-server"],
      "env": {
        "TILNOTE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Antigravity after saving.

OpenAI Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.tilnote]
command = "npx"
args = ["-y", "tilnote-mcp-server"]
env = { TILNOTE_API_KEY = "your_api_key_here" }

Environment Variables

Variable	Required	Description
TILNOTE_API_KEY	Yes	Your Tilnote API key

License

MIT

---

Tilnote MCP 서버

Tilnote에 노트를 생성, 조회, 검색, 수정할 수 있는 MCP (Model Context Protocol) 서버입니다. Claude Code, Claude Desktop, Google Antigravity, OpenAI Codex CLI와 연동하여 사용합니다.

도구

노트

도구	설명
create_note	마크다운 노트 생성 (초안으로 저장)
get_note	페이지 ID로 노트 전체 내용 조회
list_notes	최근 노트 목록과 요약 조회
search_notes	키워드로 노트 검색
update_note	기존 노트의 제목 또는 내용 수정

북(Book)

도구	설명
create_book	새 북 생성
list_books	북 목록 조회 (제목, 페이지 수, 공개 여부)
get_book	특정 북 상세 조회 (포함된 노트 목록 포함)
add_page_to_book	기존 노트를 북에 추가
remove_page_from_book	북에서 노트 제거

사전 요구 사항

• Node.js 18+ — https://nodejs.org 에서 설치 (npx 포함)

설정

1. API 키 발급

https://tilnote.io/tilnote-api 에서 API 키를 발급받으세요.

2. MCP 클라이언트 설정

Claude Code (.mcp.json)

{
  "mcpServers": {
    "tilnote": {
      "command": "npx",
      "args": ["-y", "tilnote-mcp-server"],
      "env": {
        "TILNOTE_API_KEY": "발급받은_API_키"
      }
    }
  }
}

Claude Desktop

OS	설정 파일 위치
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tilnote": {
      "command": "npx",
      "args": ["-y", "tilnote-mcp-server"],
      "env": {
        "TILNOTE_API_KEY": "발급받은_API_키"
      }
    }
  }
}

Google Antigravity

Manage MCP Servers → View raw config → ~/.gemini/antigravity/mcp_config.json 열기

{
  "mcpServers": {
    "tilnote": {
      "command": "npx",
      "args": ["-y", "tilnote-mcp-server"],
      "env": {
        "TILNOTE_API_KEY": "발급받은_API_키"
      }
    }
  }
}

저장 후 Antigravity를 재시작하세요.

OpenAI Codex CLI

~/.codex/config.toml 에 추가:

[mcp_servers.tilnote]
command = "npx"
args = ["-y", "tilnote-mcp-server"]
env = { TILNOTE_API_KEY = "발급받은_API_키" }

환경 변수

변수	필수	설명
TILNOTE_API_KEY	필수	틸노트 API 키

라이선스

MIT