A modern subscription expense tracker with automated reminders and calendar integration
- 📊 Subscription Tracking - Monthly and annual subscriptions with smart cost calculations
- 💳 Credit / Installment Tracking - Track car loans, 4x payments and any fixed-term recurring expense with automatic expiry
- 🎯 Trial Management - Monitor free trials with expiration alerts
- 📅 Calendar Integration - iCal subscription for Apple Calendar, Google Calendar, Outlook
- 🔔 Smart Notifications - Email and browser push notifications (configurable 1-7 days before)
- 📈 Analytics - Interactive charts by category and spending trends
- 🎨 Multiple Themes - Dark, Light, Dracula, Nord, Solarized
- 💱 Multi-Currency - EUR and USD with cross-device sync
- 🌐 i18n - English and French support
- 📱 Responsive - Works seamlessly on desktop, tablet, and mobile
- 🔐 Secure - JWT auth, bcrypt passwords, email verification, invitation system
- 🔑 API Token - Persistent non-expiring token for external integrations and scripts
- 🤖 MCP Server - Streamable HTTP MCP endpoint to control Subly via AI assistants (Claude, Cursor…)
- Create a docker-compose.yml file:
services:
mongodb:
image: mongo:8.0
container_name: subly-mongodb
environment:
- MONGO_INITDB_ROOT_USERNAME=subly_admin
- MONGO_INITDB_ROOT_PASSWORD=change_this_password
- MONGO_INITDB_DATABASE=subly
volumes:
- mongodb_data:/data/db
- mongodb_config:/data/configdb
restart: unless-stopped
healthcheck:
test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')"]
interval: 10s
timeout: 5s
retries: 5
subly:
image: zlimteck/subly:latest
container_name: subly-app
ports:
- "3000:80"
- "5071:5071"
environment:
- NODE_ENV=production
- PORT=5071
- MONGODB_URI=mongodb://subly_admin:change_this_password@mongodb:27017/subly?authSource=admin
- JWT_SECRET=your_secure_random_string_here
- FRONTEND_URL=http://your_ip_here:3000
- BACKEND_URL=http://your_ip_here:5071
- TZ=Europe/Paris
depends_on:
mongodb:
condition: service_healthy
restart: unless-stopped
volumes:
mongodb_data:
driver: local
mongodb_config:
driver: local- Start the services:
docker-compose up -d- Generate an invitation code:
docker exec -it subly-app node /app/backend/scripts/generateInvite.js- Access the app:
- Open http://localhost:3000
- Sign up with the invitation code
- Promote yourself to admin:
docker exec -it subly-app node /app/backend/scripts/promoteAdmin.js your-username
That's it! 🎉
- Docker Hub Image - Pull and run the pre-built image
- From Source - Clone and run locally for development
- Manual Setup - Detailed installation guide
🖼️ View Screenshots
Frontend: React 18, Vite, React Router, Recharts, Axios, date-fns, Lucide Icons
Backend: Node.js, Express, MongoDB, Mongoose, JWT, bcrypt, Resend (email), web-push, MCP SDK
DevOps: Docker, Docker Compose, Nginx, GitHub Actions
- 📖 Installation Guide - Detailed setup instructions
- 🐳 Docker Guide - Docker deployment options
- 💻 Development Guide - Local development setup
- ⚙️ Configuration - Environment variables reference
- 🔌 API Documentation - REST API endpoints
- 🤖 MCP Server - AI assistant integration
- 🏗️ Architecture - Project structure and design
Subly exposes a Model Context Protocol (MCP) server over Streamable HTTP, allowing AI assistants (Claude Desktop, Cursor, etc.) to read and manage your subscriptions directly.
Endpoint: POST http://<your-host>:5071/mcp
Authentication: Pass your Subly API Token (or JWT) as a Bearer token in the Authorization header. The API Token is recommended — it never expires and can be found in your Profile settings.
| Tool | Description |
|---|---|
list_subscriptions |
List subscriptions (optional filters: activeOnly, category) |
get_stats |
Monthly/yearly totals and spending by category |
list_categories |
List all user categories |
create_subscription |
Create a new subscription |
update_subscription |
Update an existing subscription by ID |
delete_subscription |
Delete a subscription by ID |
Claude Desktop does not support Streamable HTTP natively. Use mcp-remote as a stdio bridge — no extra install required (npx handles it).
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"subly": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:5071/mcp",
"--header",
"Authorization:Bearer <your_api_token>"
]
}
}
}Tip: Get your API Token from Profile → API Token in the Subly web app. It never expires, unlike the JWT session token.
Clients that support Streamable HTTP natively (Cursor, etc.) can connect directly:
{
"mcpServers": {
"subly": {
"type": "http",
"url": "http://localhost:5071/mcp",
"headers": {
"Authorization": "Bearer <your_api_token>"
}
}
}
}MIT License - See LICENSE for details