tilnote-mcp-server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tilnote-mcp-serversearch my notes for MCP"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tilnote MCP Server
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 a new markdown note (saved as draft) |
| Get the full content of a note by page ID |
| List your recent notes with excerpts |
| Search notes by keyword |
| Update the title or content of an existing note |
Books
Tool | Description |
| Create a new book |
| List your books with title, page count, and status |
| Get book details including its list of pages |
| Add an existing note to a 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 |
|
Windows |
|
{
"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 |
| Yes | Your Tilnote API key |
License
MIT
Tilnote MCP 서버
Tilnote에 노트를 생성, 조회, 검색, 수정할 수 있는 MCP (Model Context Protocol) 서버입니다. Claude Code, Claude Desktop, Google Antigravity, OpenAI Codex CLI와 연동하여 사용합니다.
도구
노트
도구 | 설명 |
| 마크다운 노트 생성 (초안으로 저장) |
| 페이지 ID로 노트 전체 내용 조회 |
| 최근 노트 목록과 요약 조회 |
| 키워드로 노트 검색 |
| 기존 노트의 제목 또는 내용 수정 |
북(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 |
|
Windows |
|
{
"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_키" }환경 변수
변수 | 필수 | 설명 |
| 필수 | 틸노트 API 키 |
라이선스
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/wisdomcrane/tilnote-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server