Coinio MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Coinio
A self-hosted subscription and bill tracker: one Docker container, one data folder, your server.
Türkçe · Website · Documentation · Live demo

Coinio keeps every recurring payment on one page: streaming, cloud storage, the gym, rent, the domain you renew once a year. You see what is due this week, what is left to pay this month and what the whole year costs, converted to your main currency. There is no account on someone else's server, no telemetry and no paid tier.
Try it first: the live demo is the real web app running in your browser with sample data. Nothing is sent anywhere, and it resets whenever you like.
Features
Real billing cycles. Weekly, monthly or yearly, every N cycles, charged automatically or paid by hand. Mark a payment paid, skip a period or pause a subscription; the history stays.
161 services built in. Type "spot" and Spotify fills in with its logo, category and cycle. Any other site gets its own icon.
Calendar and reminders. Payment days months ahead. Reminders, digests and trial, budget and price alerts by email, Telegram, Discord, Slack, ntfy, Gotify, Pushover, webhooks or Apprise, with editable templates.
Any currency. Each subscription keeps its own currency; totals are converted with daily exchange rates.
History and reports. What you paid over the last 12 months and what to expect in the next 12, by category.
Import and export. Bring your subscriptions over from Wallos; export subscriptions and payments as CSV or JSON.
AI assistants (MCP). A built-in MCP server with OAuth, so Claude, ChatGPT and other MCP clients can read and update your subscriptions.
iPhone widget. Home Screen and Lock Screen widgets through Scriptable, no App Store app needed.
Your own look. Themes, accent colour, fonts, density, dashboard cards, custom CSS and sandboxed HTML cards.
Eight languages: English, Turkish, German, French, Spanish, Brazilian Portuguese, Simplified Chinese and Japanese. Installable as a web app.
Related MCP server: ai-service-integration-starter
Install
Every method runs the same image, ghcr.io/yakupemreyerli/coinio:latest (amd64 and arm64). The app listens on port 8080 and keeps all its data in /data. Open http://your-server:8080 afterwards and create your account.
Install script: checks for Docker, starts Coinio on port 8080 and offers a Cloudflare Tunnel for https (read the script).
curl -fsSL https://getcoinio.me/install | shDocker:
docker run -d --name coinio --restart unless-stopped \
-p 8080:8080 -v coinio-data:/data \
ghcr.io/yakupemreyerli/coinio:latestDocker Compose: data lands in ./data next to the file; optional settings go in a .env file.
mkdir coinio && cd coinio
curl -fsSLO https://raw.githubusercontent.com/yakupemreyerli/coinio/main/docker-compose.yml
docker compose up -dPlatforms:
Platform | How |
Unraid | Template |
CasaOS | Compose file |
Portainer | App template |
Dokploy | Compose service from this repository, |
See deploy/README.md and the installation docs for details.
Configuration
Coinio is configured with environment variables. Everything else (currency, time zone, language, reminder time, appearance) is set in the app and stored in the database. An empty variable counts as not set. A starting point is in .env.example.
Variable | Default | What it does |
| not set | The address you reach Coinio at, e.g. |
| not set | Telegram bot token. With the chat ID, creates a Telegram channel on first start; then manage it in Settings › Notifications. |
| not set | Telegram chat ID for that channel. |
| not set | Optional topic ID in a forum group. |
|
| Port the server listens on inside the container. |
|
| Folder for the database ( |
| built-in | Folder with the built web app; only useful in development. |
|
| Container time zone; set it to your own, e.g. |
In Docker, leave PORT and COINIO_DATA_DIR alone: publish another port (-p 9000:8080) or mount another folder at /data instead. The container runs as user node (UID 1000), so a mounted folder must be writable by it; the entrypoint takes over root-owned folders on start. Full reference: docs.getcoinio.me/docs/reference/configuration.
HTTPS and remote access
On your home network or a VPN, http://<server-ip>:8080 is enough. The iPhone widget (away from home) and the claude.ai / ChatGPT connectors need a public https address:
Cloudflare Tunnel: the install script asks for a tunnel token and starts
cloudflarednext to Coinio, so you get https without opening any ports.Reverse proxy: if you already run Caddy, Traefik, Nginx or Dokploy, point a domain at port 8080.
Either way, set COINIO_PUBLIC_URL to that https address. See Expose to the internet.
AI assistants (MCP)
The MCP server lives at your Coinio address plus /mcp. Cloud apps such as claude.ai and ChatGPT sign in with OAuth (needs COINIO_PUBLIC_URL on https); tools on your own machine use an API key from Settings › Integrations › API keys. Settings › Integrations shows ready-made snippets. Guide: docs.getcoinio.me/docs/integrations/mcp.
iPhone widget
widget/coinio-widget.js is a Scriptable script for small, medium and large Home Screen widgets and Lock Screen widgets. Create a read-only API key, paste the script, fill in SERVER_URL and API_KEY. Guide: docs.getcoinio.me/docs/integrations/iphone-widget.
Updating
Database migrations run by themselves when a new version starts.
# Compose
docker compose pull && docker compose up -d
# docker run: pull, remove the container, start it again with the same command
docker pull ghcr.io/yakupemreyerli/coinio:latest
docker rm -f coinio
docker run -d --name coinio --restart unless-stopped \
-p 8080:8080 -v coinio-data:/data \
ghcr.io/yakupemreyerli/coinio:latestIf you installed with the script, run the script again instead of the last command.
Backups
Everything lives in /data: the SQLite database (coinio.db, WAL mode) and the logos. Back up that folder and you have it all. With the install script or docker run the volume is coinio-data:
docker stop coinio
docker run --rm -v coinio-data:/data -v "$PWD":/backup alpine \
tar czf /backup/coinio-backup.tar.gz -C /data .
docker start coinioWith Compose, archive the ./data folder while the container is stopped. The backup holds API keys, notification tokens and sessions, so store it like a password. You can also export subscriptions and payments as CSV or JSON from the app. Restore steps: docs.getcoinio.me/docs/maintenance.
Development
Requires Node.js 22 and pnpm 12.
pnpm install
pnpm dev # web on http://localhost:4660, API on :4661, data in ./.data
pnpm test # Vitest: server and web
pnpm typecheck
pnpm build # dist/server and dist/web
pnpm build:demo # browser-only demo into site/demo/The docs site is a separate package: cd docs-site && pnpm install && pnpm dev. See CONTRIBUTING.md for the rest.
Project structure
src/server/ Express API, SQLite (Drizzle), auth, OAuth, MCP server, scheduler, services
src/web/ React + Vite web app (routes, dashboard cards, settings, i18n, demo backend)
src/shared/ Logic shared by server, web and demo: schedule, catalog, appearance, types
tests/ Server tests (web tests sit next to their components)
widget/ Scriptable iPhone widget
deploy/ Unraid, CasaOS and Portainer templates
site/ Landing page (getcoinio.me), install script and the built demo in site/demo/
docs-site/ Documentation (docs.getcoinio.me), Fumadocs on Next.js
docs/ Brand assets and the README bannersCredits
Brand logos come from Simple Icons (CC0-1.0). The logos are trademarks of their owners; using them does not imply endorsement.
When a service has no Simple Icons logo, Coinio fetches the site's own icon, or Google's and DuckDuckGo's favicon services.
Exchange rates from Frankfurter, which publishes European Central Bank reference rates.
Fonts via Fontsource and Google Fonts: Geist, Geist Mono, Inter, Manrope, Space Grotesk, Bricolage Grotesque, Fraunces, Instrument Serif, IBM Plex Mono and Plus Jakarta Sans, all under the SIL Open Font License 1.1.
Icons by Lucide (ISC). The docs site is built with Fumadocs.
License
MIT © 2026 Yakup Emre Yerli
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect MCP clients to 2,000+ AI models without managing provider API keys.
Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude Desktop and other MCP clients to interact with any OAuth2-authenticated OpenAPI-based API through automatic tool generation from OpenAPI specifications, with built-in token management and authentication handling.7 npm3MIT
- AlicenseNot gradedqualityCmaintenanceEnables exposing product capabilities to ChatGPT, Claude, and other MCP clients via a stateless Streamable HTTP endpoint with OAuth resource binding and structured-output helpers.MIT
- AlicenseAqualityCmaintenanceEnables Claude, ChatGPT and other MCP clients to read an Amiqus ID account—clients, onboarding records and steps, check results, templates, case status counts and webhooks—and, when writes are enabled, create records.9MIT
- AlicenseNot gradedqualityCmaintenanceEnables existing websites to expose their features to Claude, ChatGPT, and custom AI agents over MCP, with OAuth consent, scoped permissions, user-set limits, and an audit log.371 npmMIT