Skip to main content
Glama
Sign In
calso

calso

by soroush83faraz
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

کالسو (Calso) ✦

تقویم شمسی + مدیریت کارها، شخصی و لوکال — با سرور MCP برای اتصال به AI.

🔗 صفحه ورود و نصب روی گوشی: soroush83faraz.github.io/calso

دو نسخه دارد:

  • نسخه آفلاین (PWA) — soroush83faraz.github.io/calso/app: مستقیم از گیت‌هاب اجرا می‌شود، دیتا در خود دستگاه (IndexedDB)، بدون اینترنت هم کار می‌کند، از کروم قابل نصب روی گوشی. سورس بک‌اند مرورگری: web/src/local/

  • نسخه لوکال — سرور Node + SQLite روی کامپیوتر خودت با MCP و نوتیف ویندوز (پایین‌تر)

  • Todo به سبک Microsoft To Do: روز من + پیشنهادها، مهم، لیست‌ها با رنگ/ایموجی، گروه‌بندی، زیرتسک (Steps)، یادداشت، ضمیمه فایل، ددلاین/یادآوری/تکرار (شمسی!)، مرتب‌سازی و درگ‌اند‌دراپ، جستجو، انجام‌شده‌ها، دارک مود

  • تقویم: شمسی + میلادی، مناسبت‌ها و تعطیلات رسمی ایران، رویدادها، سوییچ شمسی/میلادی، خروجی PDF ماهانه، تبدیل تاریخ، محاسبه سن، فاصله دو تاریخ، ساعت جهانی، قطب‌نما (روی گوشی)

  • نوتیفیکیشن: توست ویندوز + پوش گوشی از طریق ntfy

  • MCP: ۱۷ ابزار برای اینکه AI تسک بسازد، برنامه‌ات را بخواند و روزت را برنامه‌ریزی کند

اجرا

# بار اول (نصب وابستگی‌ها + بیلد رابط):
npm run setup

# هر بار:
npm start          # یا دابل‌کلیک روی start-calso.bat

بعد باز کن: http://localhost:4820 از گوشی (همان وای‌فای): آدرس IP سیستم را که موقع اجرا چاپ می‌شود باز کن، مثلا http://192.168.1.5:4820

نصب روی گوشی (مثل یک اپ)

اپ را در کروم گوشی باز کن → منوی ⋮ → Add to Home screen. آیکون کالسو به صفحه اصلی اضافه می‌شود. راهنمای کامل: صفحه ورود

اجرای خودکار با روشن شدن ویندوز (اختیاری)

Win+R → بنویس shell:startup → Enter → یک Shortcut از start-calso.bat داخل آن پوشه بگذار.

Related MCP server: mcp-labrat

اتصال به AI (MCP)

claude mcp add calso -- node "C:\Users\Lenovo\projects\calso\mcp\server.js"

بعد در Claude Code می‌توانی بگویی:

  • «فردا ساعت ۵ یادم بنداز برم خرید»

  • «برنامه این هفته‌ام چیه؟»

  • «روزم رو برنامه‌ریزی کن»

  • «تسک‌های مهم عقب‌افتاده‌ام رو بذار توی روز من»

نوتیف گوشی (ntfy)

  1. اپ ntfy را نصب کن (گوگل‌پلی یا F-Droid)

  2. ساده‌ترین راه: در تنظیمات کالسو، سرور را https://ntfy.sh و تاپیک را یک اسم یکتا بگذار (مثل calso-soroush-x7k2) و در اپ ntfy همان تاپیک را Subscribe کن

  3. بدون اینترنت/برای وای‌فای خانه: باینری ویندوز ntfy را دانلود و با ntfy serve --listen-http :8090 اجرا کن؛ در کالسو سرور را http://IP-سیستم:8090 بگذار و در اپ گوشی هم Default server را همین آدرس بده

  4. دکمه «تست نوتیف گوشی» در تنظیمات را بزن

ساختار

server/   Express API + SQLite + زمان‌بند یادآوری + نوتیف
mcp/      سرور MCP (stdio) — همان دیتابیس
web/      رابط React (RTL، وزیرمتن، تم روشن/تیره)
server/data/events.json   مناسبت‌های ایران (از پروژه متن‌باز persian-calendar)

دیتای تو فقط در server/data/calso.db روی همین سیستم است — هیچ‌چیز جایی آپلود نمی‌شود.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-labrat

      hussainkazemian
      A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables interaction with CalDAV calendars to manage events and check availability through natural language or voice commands. It provides specific tools for listing, searching, and creating calendar entries using an OpenAI-compatible interface.
      ISC

    • caldav-mcp

      eSolovyov21
      A
      license
      Not graded
      quality
      A
      maintenance
      This MCP server connects AI assistants to CalDAV servers so they can list calendars, manage events, and handle tasks (VTODOs) directly. It enables creating, updating, completing, and deleting events and todos, with support for date-range queries, recurrence rules, all-day events, and status-based task filtering.
      511 npm
      MIT