ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ ติดตั้งในเครื่อง
- บัญชีหรือคีย์ ต้องมี ICLOUD_PASSWORD · ต้องกรอกค่าตั้ง 1 ช่อง (ICLOUD_USERNAME)
- หมวด เอกสาร ตาราง และงานออฟฟิศ
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
iCloud Calendar over CalDAV: list, create, update, move and delete events. Optional read-only mode.ใช้คู่กับ
Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้
watermarks-remover
watermarks-remover เป็นแอปที่เน้นความเป็นส่วนตัว ใช้สำหรับลบลายน้ำ AI ออกจากเนื้อหาที่ผู้ใช้เป็นเจ้าของ
obsidian-skills
obsidian-skills คือชุดทักษะสำหรับ AI เพื่อให้ใช้งาน Obsidian CLI และรูปแบบไฟล์ของ Obsidian ได้ เช่น Markdown, Bases และ JSON Canvas
ทำไมอยู่อันดับนี้
หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้
| ความนิยม | 0/80 | ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20 |
|---|---|---|
| ความสด | 12/12 | ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม |
| ระบบยังตอบ | 0/8 | endpoint บนคลาวด์ตอบตอนตรวจล่าสุด |
| คะแนนการใช้งาน | 12/100 |
คุณภาพ: ผลตรวจเบื้องต้นผ่าน 3/3 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ให้ AI ติดตั้งให้ด้วยประโยคเดียว
ติดตั้ง iCloud Calendar (CalDAV) ให้หน่อย ทำตาม https://mcp.popnx.com/i/glob0x17-mcp-icloud-caldav.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรันคัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน
ผลตรวจผ่าน 3/3 · ทำงานบนเครื่องคุณ · ✓ ตรวจคำสั่งแล้ว 14 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ iCloud Calendar (CalDAV) (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (ICLOUD_USERNAME) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ Claude AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ iCloud Calendar (CalDAV) ให้ Claude ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "icloud-caldav": { "command": "uvx", "args": [ "mcp-icloud-caldav" ], "env": { "ICLOUD_USERNAME": "ใส่ค่าของคุณ", "ICLOUD_PASSWORD": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง ICLOUD_PASSWORD, ICLOUD_USERNAME ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ iCloud Calendar (CalDAV) ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง uv ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
uv --version- ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ iCloud Calendar (CalDAV)
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
กรอกค่าตั้ง 1 ช่อง
ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย
ICLOUD_USERNAMEApple ID email address
คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
เปิดไฟล์ตั้งค่าของแอป Claude บนคอม
SettingsDeveloperEdit Config
วางค่าตั้งนี้แล้วบันทึกไฟล์
{ "mcpServers": { "icloud-caldav": { "command": "uvx", "args": [ "mcp-icloud-caldav" ], "env": { "ICLOUD_USERNAME": "ใส่ค่าของคุณ", "ICLOUD_PASSWORD": "ใส่ค่าของคุณ" } } } }วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ปิดแอป Claude แล้วเปิดใหม่
ลองเลย
ใช้ iCloud Calendar (CalDAV) บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ iCloud Calendar (CalDAV) หรือมีชื่อเครื่องมือของ iCloud Calendar (CalDAV) ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 2 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
MCP_ICAL_READ_ONLYตั้งเป็น true เพื่อไม่รวมเครื่องมือสร้าง อัปเดต และลบ· ค่าเริ่มต้น falseดูต้นฉบับภาษาอังกฤษ
Set to true to leave out the create, update and delete toolsMCP_ICAL_LOG_LEVELระดับล็อกบน stderr: TRACE, DEBUG, INFO, WARNING หรือ ERROR· ค่าเริ่มต้น INFOดูต้นฉบับภาษาอังกฤษ
Log level on stderr: TRACE, DEBUG, INFO, WARNING or ERROR
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ChatGPT ยังต่อ iCloud Calendar (CalDAV) ไม่ได้
iCloud Calendar (CalDAV) ต้องติดตั้งในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะตัวที่ทำงานบนเว็บ
คุณทำแบบนี้แทนได้
ก · ใช้แอปที่ต่อ iCloud Calendar (CalDAV) ได้
- ต้องมีคีย์ของ iCloud Calendar (CalDAV) (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (ICLOUD_USERNAME) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
- ต้องมีคีย์ของ iCloud Calendar (CalDAV) (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (ICLOUD_USERNAME) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
- ต้องมีคีย์ของ iCloud Calendar (CalDAV) (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (ICLOUD_USERNAME) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
- ต้องมีคีย์ของ iCloud Calendar (CalDAV) (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (ICLOUD_USERNAME) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ต่อกับ Claude Code ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ iCloud Calendar (CalDAV) (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (ICLOUD_USERNAME) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ Claude Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ iCloud Calendar (CalDAV) ให้ Claude Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): claude mcp add --scope user icloud-caldav --env ICLOUD_USERNAME='ใส่ค่าของคุณ' --env ICLOUD_PASSWORD='ใส่ค่าของคุณ' -- uvx mcp-icloud-caldav 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง ICLOUD_PASSWORD, ICLOUD_USERNAME ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ iCloud Calendar (CalDAV) ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง uv ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
uv --version- ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ iCloud Calendar (CalDAV)
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
กรอกค่าตั้ง 1 ช่อง
ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย
ICLOUD_USERNAMEApple ID email address
คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
วางคำสั่งนี้แล้วกด Enter
claude mcp add --scope user icloud-caldav --env ICLOUD_USERNAME='ใส่ค่าของคุณ' --env ICLOUD_PASSWORD='ใส่ค่าของคุณ' -- uvx mcp-icloud-caldavแก้ “ใส่ค่าของคุณ” เป็นคีย์ของคุณก่อนกด Enter
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
พิมพ์ /mcp ใน Claude Code
ต้องเห็น iCloud Calendar (CalDAV) ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ลองเลย
ใช้ iCloud Calendar (CalDAV) บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ iCloud Calendar (CalDAV) หรือมีชื่อเครื่องมือของ iCloud Calendar (CalDAV) ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 2 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
MCP_ICAL_READ_ONLYตั้งเป็น true เพื่อไม่รวมเครื่องมือสร้าง อัปเดต และลบ· ค่าเริ่มต้น falseดูต้นฉบับภาษาอังกฤษ
Set to true to leave out the create, update and delete toolsMCP_ICAL_LOG_LEVELระดับล็อกบน stderr: TRACE, DEBUG, INFO, WARNING หรือ ERROR· ค่าเริ่มต้น INFOดูต้นฉบับภาษาอังกฤษ
Log level on stderr: TRACE, DEBUG, INFO, WARNING or ERROR
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ iCloud Calendar (CalDAV) (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (ICLOUD_USERNAME) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ Cursor AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ iCloud Calendar (CalDAV) ให้ Cursor ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "icloud-caldav": { "command": "uvx", "args": [ "mcp-icloud-caldav" ], "env": { "ICLOUD_USERNAME": "ใส่ค่าของคุณ", "ICLOUD_PASSWORD": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง ICLOUD_PASSWORD, ICLOUD_USERNAME ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ iCloud Calendar (CalDAV) ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง uv ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
uv --version- ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ iCloud Calendar (CalDAV)
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
กรอกค่าตั้ง 1 ช่อง
ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย
ICLOUD_USERNAMEApple ID email address
คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ iCloud Calendar (CalDAV) ช่อง ICLOUD_PASSWORD, ICLOUD_USERNAME ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
เปิดแชตของ AI ใน Cursor โหมด Agent
ลองเลย
ใช้ iCloud Calendar (CalDAV) บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ iCloud Calendar (CalDAV) หรือมีชื่อเครื่องมือของ iCloud Calendar (CalDAV) ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 2 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
MCP_ICAL_READ_ONLYตั้งเป็น true เพื่อไม่รวมเครื่องมือสร้าง อัปเดต และลบ· ค่าเริ่มต้น falseดูต้นฉบับภาษาอังกฤษ
Set to true to leave out the create, update and delete toolsMCP_ICAL_LOG_LEVELระดับล็อกบน stderr: TRACE, DEBUG, INFO, WARNING หรือ ERROR· ค่าเริ่มต้น INFOดูต้นฉบับภาษาอังกฤษ
Log level on stderr: TRACE, DEBUG, INFO, WARNING or ERROR
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ iCloud Calendar (CalDAV) (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (ICLOUD_USERNAME) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ VS Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ iCloud Calendar (CalDAV) ให้ VS Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "servers": { "icloud-caldav": { "type": "stdio", "command": "uvx", "args": [ "mcp-icloud-caldav" ], "env": { "ICLOUD_USERNAME": "ใส่ค่าของคุณ", "ICLOUD_PASSWORD": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง ICLOUD_PASSWORD, ICLOUD_USERNAME ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ iCloud Calendar (CalDAV) ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง uv ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
uv --version- ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ iCloud Calendar (CalDAV)
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
กรอกค่าตั้ง 1 ช่อง
ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย
ICLOUD_USERNAMEApple ID email address
คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ iCloud Calendar (CalDAV) ช่อง ICLOUD_PASSWORD, ICLOUD_USERNAME ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
เปิดแชตของ AI ใน VS Code โหมด Agent
ลองเลย
ใช้ iCloud Calendar (CalDAV) บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ iCloud Calendar (CalDAV) หรือมีชื่อเครื่องมือของ iCloud Calendar (CalDAV) ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 2 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
MCP_ICAL_READ_ONLYตั้งเป็น true เพื่อไม่รวมเครื่องมือสร้าง อัปเดต และลบ· ค่าเริ่มต้น falseดูต้นฉบับภาษาอังกฤษ
Set to true to leave out the create, update and delete toolsMCP_ICAL_LOG_LEVELระดับล็อกบน stderr: TRACE, DEBUG, INFO, WARNING หรือ ERROR· ค่าเริ่มต้น INFOดูต้นฉบับภาษาอังกฤษ
Log level on stderr: TRACE, DEBUG, INFO, WARNING or ERROR
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON
ติดตั้งในเครื่อง
Claude Code
claude mcp add --scope user icloud-caldav --env ICLOUD_USERNAME='ใส่ค่าของคุณ' --env ICLOUD_PASSWORD='ใส่ค่าของคุณ' -- uvx mcp-icloud-caldavClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"icloud-caldav": {
"command": "uvx",
"args": [
"mcp-icloud-caldav"
],
"env": {
"ICLOUD_USERNAME": "ใส่ค่าของคุณ",
"ICLOUD_PASSWORD": "ใส่ค่าของคุณ"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"icloud-caldav": {
"command": "uvx",
"args": [
"mcp-icloud-caldav"
],
"env": {
"ICLOUD_USERNAME": "ใส่ค่าของคุณ",
"ICLOUD_PASSWORD": "ใส่ค่าของคุณ"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"icloud-caldav": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-icloud-caldav"
],
"env": {
"ICLOUD_USERNAME": "ใส่ค่าของคุณ",
"ICLOUD_PASSWORD": "ใส่ค่าของคุณ"
}
}
}
}ค่าที่ต้องใส่เอง
ICLOUD_USERNAMEจำเป็น envApple ID email addressICLOUD_PASSWORDความลับ จำเป็น envApp-specific password from appleid.apple.com (not the Apple ID password)MCP_ICAL_READ_ONLYenvตั้งเป็น true เพื่อไม่รวมเครื่องมือสร้าง อัปเดต และลบดูต้นฉบับภาษาอังกฤษ
Set to true to leave out the create, update and delete toolsMCP_ICAL_LOG_LEVELenvระดับล็อกบน stderr: TRACE, DEBUG, INFO, WARNING หรือ ERRORดูต้นฉบับภาษาอังกฤษ
Log level on stderr: TRACE, DEBUG, INFO, WARNING or ERROR
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
สรุป
ใช้กับโปรแกรมไหนได้
ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ติดตั้งบนเครื่องได้ใน
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
คู่มือที่เกี่ยวข้อง
ทำอะไรได้บ้าง
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 19 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub Glob0x17 ซึ่งเป็นเจ้าของ repo
- ✓ ผ่าน
ยังมีคนดูแล
มีการแก้โค้ดล่าสุด 6 วันที่ผ่านมา
- ✓ ผ่าน
มีสัญญาอนุญาต (license)
ใช้ MIT
- – ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
ช่องโหว่ที่เปิดเผยแล้ว (OSV.dev)
ไม่พบรายการใน OSV.dev สำหรับ mcp-icloud-caldav@0.2.1
ตรวจเฉพาะตัวแพ็กเกจรุ่นนี้ ไม่ใช่ทุก dependency · ตรวจเมื่อ 15 พ.ย. 2569
ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/glob0x17-mcp-icloud-caldav)พูดคุย
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
รีวิวจากผู้ใช้
ยังไม่มีรีวิว
เทียบกับตัวอื่นในหมวด เอกสาร ตาราง และงานออฟฟิศi
- ดาวมากกว่า 0% ของอีก 4126 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 43% ของอีก 4126 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 4126 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
iCloud Calendar (CalDAV) ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 3 จาก 3 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
ต้องใส่ค่าเหล่านี้: ICLOUD_PASSWORD
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด 6 วันที่ผ่านมา และส่งรุ่นล่าสุด (0.2.1) เข้า registry 38 วันที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี 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.
| ตัวนี้ iCloud Calendar (CalDAV) | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | ต้องลงในเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ต้องลงในเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ต้องลงในเครื่อง |
| ต้องใส่คีย์ | ใช่ | ไม่ | ไม่ | ใช่ | ไม่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ |
| ผลตรวจเบื้องต้น | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| สัญญาอนุญาต | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
iCloud Calendar MCP Server
A Model Context Protocol server that gives MCP clients access to iCloud Calendar over CalDAV: list calendars, read, create, update, move and delete events. It works on Linux, macOS and Windows, since it talks to iCloud directly instead of going through the macOS Calendar app.
This is a maintained fork of zwrong/iCalendar, itself derived from the macOS mcp-ical server. See Changes in this fork.
Tools
| Tool | Description |
|---|---|
list_calendars | Names of the available calendars |
list_events | Events in a date range, optionally for one calendar, sorted by start time |
create_event | New event: title, times, all-day, location, notes, URL, alarms, recurrence |
update_event | Change any of those fields, or move the event to another calendar |
delete_event | Delete an event by identifier |
debug_calendar_connection | Connection check: calendars and event counts over the last 7 days |
The calendars://list resource also lists the calendars. With MCP_ICAL_READ_ONLY=true, the three write tools are not registered at all.
Requirements
- Python 3.12 or later and uv
- An Apple ID with iCloud Calendar enabled
- An app-specific password for that Apple ID
App-specific password
- Sign in to appleid.apple.com, open Sign-In and Security, then App-Specific Passwords.
- Generate a password, for example named
mcp-icloud-caldav.
The username is your Apple ID address, which is not necessarily an @icloud.com address. An app-specific password gives access to iCloud CalDAV, CardDAV and IMAP: keep it out of version control and revoke it if it leaks.
Installation
The package is published on PyPI as mcp-icloud-caldav. With uv, MCP clients can start it directly, without a separate install step:
uvx mcp-icloud-caldav
uvx downloads the package into a cached, isolated environment on first use. To install it permanently instead: uv tool install mcp-icloud-caldav (or pipx install mcp-icloud-caldav).
From source:
git clone https://github.com/Glob0x17/mcp-icloud-caldav.git mcp-icloud-caldav
cd mcp-icloud-caldav uv sync --no-dev uv run mcp-icloud-caldav
Configuration
Credentials are read in this order:
- Environment variables (recommended)
| Variable | Required | Default |
|---|---|---|
ICLOUD_USERNAME | yes | |
ICLOUD_PASSWORD | yes | |
CALDAV_SERVER_URL | no | https://caldav.icloud.com/ |
- `MCP_ICAL_CONFIG`: path to a JSON file shaped like
config.json.example - `config_private.json`, then `config.json`, at the repository root (kept for compatibility)
Other settings:
| Variable | Default | Effect |
|---|---|---|
MCP_ICAL_READ_ONLY | false | true leaves out create_event, update_event and delete_event |
MCP_ICAL_LOG_LEVEL | INFO | TRACE, DEBUG, INFO, WARNING or ERROR. Logs go to stderr |
The server speaks MCP over stdio and is started by the client. To check it by hand:
ICLOUD_USERNAME=you@example.com ICLOUD_PASSWORD=xxxx-xxxx-xxxx-xxxx uvx mcp-icloud-caldav
It waits on stdin and prints nothing on stdout.
Client setup
Use the absolute path of uvx (which uvx) if the client cannot find it: clients often start servers without your shell PATH, which shows up as spawn uvx ENOENT. Usual locations:
| Installed with | Path |
|---|---|
| The uv installer (Linux, macOS) | ~/.local/bin/uvx |
| Homebrew on Apple silicon | /opt/homebrew/bin/uvx |
| Homebrew on Intel Macs | /usr/local/bin/uvx |
The command and its argument are separate fields: the command is uvx (or its path) and mcp-icloud-caldav is an argument. A config where the command is the single string "uvx mcp-icloud-caldav" fails with ENOENT, because the client looks for a program with that exact name, space included.
Keeping the password out of the client config
Most clients store env values in clear text in their config file. A small wrapper that reads an env file avoids that:
mkdir -p ~/.config/mcp-icloud-caldav && chmod 700 ~/.config/mcp-icloud-caldav
cat > ~/.config/mcp-icloud-caldav/env <<'EOF' ICLOUD_USERNAME=you@example.com ICLOUD_PASSWORD=xxxx-xxxx-xxxx-xxxx MCP_ICAL_READ_ONLY=true EOF chmod 600 ~/.config/mcp-icloud-caldav/env
cat > ~/.local/bin/mcp-icloud-caldav-run <<'EOF' #!/usr/bin/env bash set -euo pipefail set -a; source "$HOME/.config/mcp-icloud-caldav/env"; set +a exec /absolute/path/to/uvx mcp-icloud-caldav EOF chmod +x ~/.local/bin/mcp-icloud-caldav-run
Then point the client at ~/.local/bin/mcp-icloud-caldav-run. Starting read-only and switching to false once reading works is a sensible first step.
Claude Desktop
In claude_desktop_config.json (Settings, Developer, Edit Config). On macOS it is ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": { "icloud-calendar": { "command": "uvx", "args": ["mcp-icloud-caldav"], "env": { "ICLOUD_USERNAME": "you@example.com", "ICLOUD_PASSWORD": "xxxx-xxxx-xxxx-xxxx" } } } }
or, with the wrapper, "command": "/home/you/.local/bin/mcp-icloud-caldav-run" and no env. Quit Claude Desktop completely and start it again after editing. On macOS, server logs are in ~/Library/Logs/Claude/mcp-server-icloud-calendar.log.
Claude Code
claude mcp add --scope user icloud-calendar \
-e ICLOUD_USERNAME=you@example.com -e ICLOUD_PASSWORD=xxxx-xxxx-xxxx-xxxx \ -- uvx mcp-icloud-caldav
or, with the wrapper, claude mcp add --scope user icloud-calendar -- ~/.local/bin/mcp-icloud-caldav-run.
Do not quote what follows --: -- uvx mcp-icloud-caldav registers uvx as the command and mcp-icloud-caldav as its argument, while -- "uvx mcp-icloud-caldav" registers one program name and fails with ENOENT. To fix an existing entry, remove it with claude mcp remove icloud-calendar --scope user and add it again.
/mcp in a session shows the server state and its tools; claude mcp get icloud-calendar shows the registered command and arguments.
Other clients
Any MCP client that can start a stdio server works: run uvx mcp-icloud-caldav with the environment variables above. The server is also listed in the MCP Registry as io.github.Glob0x17/mcp-icloud-caldav.
Behavior worth knowing
- Times. Event times are written in UTC. A time with an offset (
2030-01-07T09:30:00+01:00) is converted, and a time without one is taken as the machine's local time. Times are shown back in the machine's timezone. All-day events are written as dates, with the end date exclusive as the iCalendar standard requires. - Moving between calendars. iCloud refuses the same event UID in two calendars, so a move cannot be "copy then delete".
update_eventwithcalendar_nameuses a WebDAVMOVE, which is atomic on the server: if it fails, the event stays where it was. A move without other changes keeps the original iCalendar data untouched. - Finding events. Listings fill an in-memory index (UID to URL) that lives as long as the server process. Lookups then go straight to the event, falling back to the
/ .icsURL iCloud uses for most events, and only then to a scan of all calendars. iCloud does not support CalDAV UID searches. - Volume. iCloud returns any number of events per request. The practical limit is the client: many cap a tool result at around 25,000 tokens, roughly 300 events in this server's output, so split long ranges.
- Scope. Only calendars hosted on iCloud are visible. Exchange, Google or other accounts added to the Calendar app on a device are not reachable through iCloud CalDAV, and neither are read-only subscribed (ICS) calendars.
Privacy and security
- The only network destination is the configured CalDAV server; there is no telemetry.
- The password never appears in logs, at any level, nor in the configuration object's
repr. - Logs go to stderr only, since stdout carries the MCP protocol. Event contents (titles, notes) are logged only at
DEBUGor below; atINFO, only identifiers. Some clients save server stderr to disk, so keepDEBUGfor troubleshooting. - Dependencies are locked in
uv.lockand resolved from the official PyPI index only.
Troubleshooting
| Symptom | Likely cause |
|---|---|
401 Unauthorized | Regular Apple ID password instead of an app-specific one, or a revoked one |
spawn uvx ENOENT or ENOENT | uvx is not on the client's PATH (use its absolute path), or the command and its argument were registered as one string (see Client setup) |
| No events returned | Wrong date range, an event in a non-iCloud or subscribed calendar, or a timezone mix-up |
| Server does not respond | Something writes to stdout and breaks the stdio protocol |
Calendar 'X' not found | Calendar names are case-sensitive: check list_calendars |
debug_calendar_connection and MCP_ICAL_LOG_LEVEL=DEBUG help narrow things down.
Development
uv sync
uv run pytest -m "not integration" # unit tests, CalDAV client mocked, no network uv run ruff check .
Integration tests run against a real account, read-only, and are skipped unless credentials are set:
ICLOUD_USERNAME=... ICLOUD_PASSWORD=... uv run pytest -m integration
Project layout:
mcp_icloud_caldav/
├── server.py # MCP server, tool registration, logging setup ├── caldav_client.py # CalDAV access: search, create, update, move, delete, event index ├── ical.py # Thin calendar manager used by the server ├── models.py # Event and request models, iCalendar parsing └── config.py # Configuration loading tests/ # Unit tests tests/integration/ # Read-only tests against a real account
Changes in this fork
0.2.1: documentation only (uvx locations, ENOENT causes, client paths on macOS).
0.2.0, compared with zwrong/iCalendar 0.1.0:
- Dependencies. Lockfile regenerated from the official PyPI index (it resolved packages through a third-party mirror over plain HTTP). Upgrade to
mcp2.x (FastMCPbecameMCPServer) andcaldav3.x; the original code no longer starts against current releases. - Configuration. Environment variables,
MCP_ICAL_CONFIG, read-only mode, configurable log level, no event contents in logs aboveDEBUG. - Fixes.
- Creating an event with a timezone offset failed (
Unable to guess TZID); all-day events and recurrence end dates were written incorrectly. - Alarms were never read back.
- Updating an event without a location, notes or URL failed; changing its time produced invalid iCalendar data.
- Moving an event deleted it before saving the copy, so a failed save lost it.
- New events got a UID containing spaces and the machine's hostname.
- Behavior. Events sorted by start time, compact output without empty fields, in-memory event index.
- Tests. Unit tests for configuration, read-only mode, logging, iCalendar output, moves and lookups.
- Packaging. Published on PyPI as
mcp-icloud-caldavand listed in the MCP Registry. The Python package and the command are renamed frommcp_ical/mcp-ical, which clashed with the original macOS project. The unusedmcp[cli]extra was dropped