ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ คลาวด์ (ต่อผ่านอินเทอร์เน็ต)
- บัญชีหรือคีย์ ล็อกอินกับบริการตอนต่อ (OAuth)
- หมวด เอกสาร ตาราง และงานออฟฟิศ
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Read and manage To-do Calendar todos, schedules and tags from an AI agent.ใช้คู่กับ
Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้
watermarks-remover
watermarks-remover เป็นแอปที่เน้นความเป็นส่วนตัว ใช้สำหรับลบลายน้ำ AI ออกจากเนื้อหาที่ผู้ใช้เป็นเจ้าของ
obsidian-skills
obsidian-skills คือชุดทักษะสำหรับ AI เพื่อให้ใช้งาน Obsidian CLI และรูปแบบไฟล์ของ Obsidian ได้ เช่น Markdown, Bases และ JSON Canvas
ทำไมอยู่อันดับนี้
ตัวนี้อยู่ในแท็บ "แอปที่ต่อกับ AI" ซึ่งเรียงโดยไม่ใช้ดาว ตามลำดับเหล่านี้
| 1. อยู่ในสมุด connector ของ Claude | ไม่ | |
|---|---|---|
| 2. ทีมลองใช้จริงแล้ว | ไม่ | |
| 3. ใช้กับงานคนไทย | ไม่ | |
| 4. การใช้งานไม่นับดาว | 20/100 | ความนิยม 0 · ความสด 12 · ระบบยังตอบ 8 · ถูกใจจากผู้ใช้ +0 |
| 5. ลงทะเบียนเมื่อ | 2026-11-15 |
ถูกใจจากผู้ใช้: 0 · บวกในลำดับได้สูงสุด 5 คะแนน (1 คะแนนต่อ 1 คน) ไม่มีใครจ่ายเงินเพื่อเพิ่มได้
คุณภาพ: ผลตรวจเบื้องต้นผ่าน 4/4 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง)
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ให้ AI ติดตั้งให้ด้วยประโยคเดียว
ติดตั้ง To-do Calendar ให้หน่อย ทำตาม https://mcp.popnx.com/i/todo-calendar.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรันคัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน
ผลตรวจผ่าน 4/4 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (mcp.todo-calendar.com) · ✓ ตรวจคำสั่งแล้ว 15 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม
เปิดหน้า Connectors ของ Claude
CustomizeConnectors
กด “Add” → “Custom” → “Web” แล้วกรอก 2 ช่องนี้
คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue
Name · ชื่อTo-do CalendarRemote MCP server URL · ที่อยู่https://mcp.todo-calendar.com/mcpกด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add
เปิดใช้ในแชต
+ConnectorsTo-do Calendar
ลองเลย
ใช้ To-do Calendar บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ To-do Calendar หรือมีชื่อเครื่องมือของ To-do Calendar ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ ChatGPT ได้ ขึ้นกับแผน
MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น
เปิดหน้าเพิ่ม MCP ของ ChatGPT บนเว็บ
Plugins+Add custom MCP server
กรอกชื่อและที่อยู่
ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin
Name · ชื่อTo-do CalendarConnection · ที่อยู่https://mcp.todo-calendar.com/mcpเลือก To-do Calendar ในแชต
เปิดแชตใหม่แล้วเลือก To-do Calendar จากรายการปลั๊กอินก่อนพิมพ์
ลองเลย
ใช้ To-do Calendar บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า ChatGPT บอกว่ากำลังใช้ To-do Calendar หรือมีชื่อเครื่องมือของ To-do Calendar ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Claude Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
วางคำสั่งนี้แล้วกด Enter
claude mcp add --transport http --scope user todo-calendar https://mcp.todo-calendar.com/mcpพิมพ์ /mcp ใน Claude Code
ต้องเห็น To-do Calendar ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ลองเลย
ใช้ To-do Calendar บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ To-do Calendar หรือมีชื่อเครื่องมือของ To-do Calendar ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
เปิดแชตของ AI ใน Cursor โหมด Agent
ลองเลย
ใช้ To-do Calendar บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ To-do Calendar หรือมีชื่อเครื่องมือของ To-do Calendar ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
เปิดแชตของ AI ใน VS Code โหมด Agent
ลองเลย
ใช้ To-do Calendar บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ To-do Calendar หรือมีชื่อเครื่องมือของ To-do Calendar ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ
https://mcp.todo-calendar.com/mcpค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON
ต่อผ่านเว็บ
Claude Code
claude mcp add --transport http --scope user todo-calendar https://mcp.todo-calendar.com/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"todo-calendar": {
"url": "https://mcp.todo-calendar.com/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"todo-calendar": {
"type": "http",
"url": "https://mcp.todo-calendar.com/mcp"
}
}
}ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
สรุป
- ดาวน์โหลดต่อสัปดาห์i
- ไม่มียอดใน npm/PyPI
- โดเมนที่ยืนยัน
- ✓ todo-calendar.com
- การเชื่อมต่อ
- รันบนคลาวด์
- ช่องทาง (transport)
- streamable-http
- รุ่นล่าสุดi
- 1.0.2
- ส่งเข้า registryi
- 15 พ.ย. 2569
- แก้โค้ดล่าสุดi
- 16 พ.ย. 2569
- ตรวจล่าสุดเมื่อ
- 15 พ.ย. 2569
- ผู้ทำ
- sudopark
- เว็บผู้ทำ
- todo-calendar.com
- สถานะใน registry
- ใช้งานอยู่
ใช้กับโปรแกรมไหนได้
ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ต่อผ่านคลาวด์ได้ใน
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
คู่มือที่เกี่ยวข้อง
ทำอะไรได้บ้าง
server ให้ล็อกอินก่อนจึงจะแสดงรายการเครื่องมือ
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 19 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันโดเมน todo-calendar.com แล้ว (registry ตรวจความเป็นเจ้าของโดเมน)
- ✓ ผ่าน
ยังมีคนดูแล
มีการแก้โค้ดล่าสุด 3 วันที่ผ่านมา
- – ไม่เกี่ยว
มีสัญญาอนุญาต (license)
ไม่เกี่ยว: server บนคลาวด์ของเจ้าของ todo-calendar.com เอง คุณไม่ได้รันโค้ดจากรีโป
- ✓ ผ่าน
endpoint ตอบ
ตอบกลับใน 268 ms (HTTP 401)
- ✓ ผ่าน
ล็อกอินแบบ OAuth
ประกาศวิธีล็อกอินแบบ OAuth ให้โปรแกรม AI พาไปล็อกอินเอง
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
ยังไม่ได้ตรวจ เราอ่านรายการเครื่องมือตอนตรวจ endpoint
ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/todo-calendar)พูดคุย
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
รีวิวจากผู้ใช้
ยังไม่มีรีวิว
เทียบกับตัวอื่นในหมวด เอกสาร ตาราง และงานออฟฟิศi
- ดาวมากกว่า 0% ของอีก 4126 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 88% ของอีก 4126 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 4126 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
To-do Calendar ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 4 จาก 4 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
รันบนคลาวด์ของผู้ทำ ต่อผ่านอินเทอร์เน็ตได้เลย ไม่ต้องลงโปรแกรม แต่ข้อมูลที่ส่งให้จะผ่านเซิร์ฟเวอร์ของผู้ทำ
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด 3 วันที่ผ่านมา และส่งรุ่นล่าสุด (1.0.2) เข้า registry 4 วันที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
ตัวอื่นที่ทำงานคล้ายกัน
หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Puter MCP
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP
ให้ AI จัดการโปรเจกต์ Xcode สั่ง build และใช้ iOS Simulator
Vexa
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Atlassian Rovo MCP Server
server ทางการของ Atlassian ให้ AI ค้นและจัดการงานใน Jira และเอกสารใน Confluence ต่อผ่านคลาวด์และล็อกอินแบบ OAuth
Anki MCP Server
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| ตัวนี้ To-do Calendar | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ต้องลงในเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ต้องลงในเครื่อง |
| ต้องใส่คีย์ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ |
| ผลตรวจเบื้องต้น | 4/4 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| สัญญาอนุญาต | – | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
TodoCalendar-mcp
An MCP server and npm tool library that let AI agents work with To-do Calendar todos, schedules and tags.
Two entry points, one tool layer:
- MCP server (Streamable HTTP) — for external AI agents (Claude Desktop and others)
- `todocalendar-tools` (npmjs.com, public) — imported directly by first-party AI hosts
Connect from Claude
*For anyone connecting the hosted server from Claude, and for directory reviewers. Everything below this section is developer documentation, in Korean.*
1. Add the connector. In Claude, open Settings → Connectors → Add custom connector and enter:
https://mcp.todo-calendar.com/mcp
2. Sign in. Claude redirects you to the To-do Calendar sign-in page. The consent screen lists the two scopes being requested — read:calendar and write:calendar. The connector only ever acts on the account that approved it: the user identity is read from the verified access token, never from a tool argument.
3. Ask for something. A few prompts that exercise the main paths:
| Prompt | Tool |
|---|---|
| "What's on my calendar this week?" | get_expanded_schedules |
| "What to-dos do I have open?" | get_todos |
| "Add a to-do: buy coffee beans, tomorrow 9am" | create_todo |
| "Move it to 10am" | update_todo |
| "Mark it done" | complete_todo |
| "Add a weekly team meeting, Mondays 10am" | create_schedule |
| "Skip next Monday's team meeting" | exclude_schedule_occurrence |
| "Delete the team meeting" | delete_schedule (two steps — see below) |
Deleting takes two steps. delete_todo and delete_schedule do not delete on the first call. The first call changes nothing and returns a confirmation message with a token; the deletion happens only when the assistant calls again with the same arguments plus that token. Tokens expire after 5 minutes and are bound to the user, the tool and the arguments, so they cannot be replayed elsewhere.
Disconnecting. End the connection from Claude's connector settings, which drops the tokens it holds. Access tokens are short-lived (2 hours), and the refresh token can be revoked at the authorization server's RFC 7009 revocation endpoint.
What the tools cover
30 tools. Repeating events are expanded on the server, so you get the dates each occurrence actually falls on — weekday accrual, month-end skips, leap years and lunar rules included.
| To-dos | list, create, edit, complete, restore, replace, delete |
| Schedules | list, create, edit, delete; edit or skip a single occurrence; split a repeating series |
| Tags | list, create, edit, delete |
| Event details | place, link, memo |
| Pinned event | read, set, clear |
Every tool carries a title and the applicable readOnlyHint / destructiveHint in tools/list. describe_tool({name}) returns the full guide and the input/output JSON Schemas for any tool.
Privacy
Privacy policy (Korean: /privacy/ko). The "Connected external apps" section covers what a connected app can reach, which tokens are stored and for how long, and how to end a connection.
This server keeps no store of its own — it forwards requests to the To-do Calendar API and passes responses straight back.
Support
todocalendar.help@gmail.com
For external AI agents
Endpoint
https://mcp.todo-calendar.com/mcp
Streamable HTTP transport (compatible with MCP spec 2025-06-18).
Auth
OAuth 2.1 Resource Server. The Authorization Server is a separate service hosted by TodoCalendar Functions. Clients get a token there, then send:
Authorization: Bearer <RS256 JWT>
The token must carry the required scopes:
read:calendar—get_*toolswrite:calendar— create / update / delete toolsset_foremost_eventneeds both — it reads the target first to tell whether it is a todo or a schedule
The server publishes the AS location and scope list at GET /.well-known/oauth-protected-resource (RFC 9728).
Tools
30 tools, including the describe_tool meta tool. Responses are openAPI raw passthrough — no field renames, raw Unix-second timestamps kept, with *_iso siblings added alongside.
For the actual dates repeating events fall on in a range, use get_expanded_* (the server expands them into occurrences). For the raw recurrence rules only, use get_todos / get_schedules.
tools/list carries short summaries only (no outputSchema, 1–3 sentence descriptions). Each tool's full guide and complete I/O JSON Schemas come on demand from describe_tool({name}). Rules shared by every tool — ISO time handling, discriminators, the CONFIRM flow — are stated once in the initialize response instructions.
| domain | tools | CONFIRM |
|---|---|---|
| todo | get_todos / get_expanded_todos / create_todo / update_todo / complete_todo / replace_todo / delete_todo | delete_todo |
| schedule | get_schedules / get_expanded_schedules / create_schedule / update_schedule / exclude_schedule_occurrence / replace_schedule_occurrence / branch_schedule_repeating / delete_schedule | delete_schedule |
| tag | get_tags / create_tag / update_tag / delete_tag | — |
| done todo | get_done_todos / update_done_todo / revert_done_todo / delete_done_todo | — |
| event detail | get_event_details / set_event_detail / delete_event_detail | — |
| foremost event | get_foremost_event / set_foremost_event / clear_foremost_event | — |
| meta | describe_tool | — |
For detailed input/output schemas, see the describe_tool({name}) response (docs + input_schema + output_schema).
Two-step CONFIRM (delete_todo / delete_schedule): the first call deletes nothing and returns only a confirmToken; echoing the token on a second call performs the deletion. Tokens expire in 5 minutes and are bound to user + tool + args, so they cannot be reused for another user or other arguments.
For library consumers
First-party server-side AI hosts such as aiFrontAPI skip the MCP transport and import the tool functions directly.
Install
Public package on npmjs.com — no auth or .npmrc setup needed.
npm install todocalendar-tools
Use
import { tools, type Auth } from 'todocalendar-tools/tools'
// The caller builds the auth context. This library does not verify credentials: // verify the token (e.g. Firebase Auth) first, then pass the resulting userId. const auth: Auth = { userId: ' ', scopes: ['read:calendar', 'write:calendar'], // clientId?: OAuth client_id. Usually undefined on the dev/lib path. }
const result = await tools.get_todos.execute(auth, { mode: 'current' })
Caller responsibilities
- Verify the auth context: take
auth.userIdonly from a verified token'ssub. The library ignores any userId passed in tool args, but verifying the caller is your job. - Scopes are enforced only at the transport: the MCP server transport uses
auth.scopes; on the library import path they have no enforcing effect. openAPI calls always carry bothread:calendarandwrite:calendar. The field exists for shape compatibility. - Set four environment variables in the library process:
OPENAPI_BASE_URL— openAPI base URLOPENAPI_PAT_MCP— service auth PAT (mcp_format)SIGNING_SECRET— HS256 signing key forx-open-user-token(shared with openAPI)CONFIRM_SECRET— HMAC key for confirm tokens
Responses and errors
- Raw passthrough: response payloads are returned as openAPI sends them.
outputSchemadocuments the shape for the LLM and is never parsed at runtime, so extra fields are preserved. - Errors: thrown as
ToolError—{ status, code, message }.codecatalog:InvalidParameter(400) /NotFound(404) /InsufficientScope(403) /Timeout(0) and others.messageadds a natural-language explanation;codeandstatusare always the originals.
Export surface
Only todocalendar-tools/tools is public. Signature or type changes are a semver major.
License
MIT.