TAMO dienynas MCP
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.
TAMO dienynas MCP
English · Lietuviškai
Private copy. Based on upstream commit c5048f4 (sobakintech/tamo-dienynas-mcp), reviewed before use. Changes:
TAMO_ROLEtakes several terms joined with+(e.g.Amanda+Daukanto); a role is used only when exactly one role contains every term. With several roles and noTAMO_ROLE, or an ambiguous one, the server refuses and lists the roles instead of guessing.New
get_selected_roletool, andget_homeworkreturns the role it read, so every result can be checked against the intended child and school.Removed the image-publishing workflow and the upstream image reference; deploy only from this repository.
Pull upstream changes only after reviewing them.
Connect your AI assistant (Claude, ChatGPT and others) to the TAMO dienynas Lithuanian school e-diary. Once it's set up you can ask things like:
"What homework is due tomorrow, and what haven't I done yet?"
"What's my math average this semester?"
"Did I get any new grades this week?"
"What's on my schedule on Thursday?"
It is an MCP server that you run yourself with your own TAMO login. It only reads data; it never changes anything in TAMO.
This project is unofficial and not affiliated with TAMO. TAMO'sTerms of Use prohibit programmatic access outside documented integrations. Use it at your own risk, only with your own account; see the API reference's disclaimer.
What it can read
Tool | What it returns |
| Lessons for a week: times, subject, teacher, topic, grades, formative assessments, homework, test labels |
| Grades, formative assessments and attendance for a date range (up to 400 days) |
| Homework due in a date range, with attachments and completion state, filterable by done / not done |
| What was done in lessons |
| The recent feed: new grades, homework, absences, praise, remarks |
| Holidays, breaks and school-wide events for a month |
| Message list (sender, subject, unread). Bodies are not opened, because opening marks a message as read |
| Per-subject averages, final grades and marks for a semester or the year |
Nothing is written back to TAMO: no message is opened and no homework is ticked. Some data requires an active TAMO IŠMANIEMS subscription on the account.
Related MCP server: EduPage MCP Server
Your login and privacy
Your TAMO username and password stay in your own deployment's environment variables. The server talks only to TAMO and to the AI clients you connect; nothing is stored, cached or sent anywhere else. Every request reads fresh data, and the server limits how many requests it sends to TAMO per minute.
The server is protected by two secrets that you choose: a bearer token for clients that can send headers, and a secret URL path for clients that only accept a URL. Treat both like passwords — anyone who has them can read your diary.
Setup
You need somewhere to run the server that your AI client can reach over HTTPS. Pick one option below, then connect your client.
Option 1: Render (no server needed)
Click the button and sign in to Render (a free account is enough).
Enter your
TAMO_USERNAMEandTAMO_PASSWORD. Render generatesMCP_TOKENandMCP_PATH_TOKENfor you.When the deploy finishes, open the service's Environment tab and copy
MCP_PATH_TOKEN. Your server address is shown at the top of the page, for examplehttps://tamo-dienynas-mcp-xxxx.onrender.com.
Render's free plan puts the server to sleep after 15 minutes without requests, so the first question after a break can take up to a minute or fail once. Ask again, or use a paid instance to keep it awake.
Option 2: Docker
A ready-made image is published at ghcr.io/sobakintech/tamo-dienynas-mcp.
cp .env.example .env # then fill in the values
docker compose up -dor without Compose:
docker run -d --name tamo-mcp --env-file .env -p 8000:8000 --restart unless-stopped ghcr.io/sobakintech/tamo-dienynas-mcp:latestPut it behind a reverse proxy with HTTPS (Caddy, Traefik, nginx, Cloudflare Tunnel…). Any platform that runs Dockerfiles or Node apps — Coolify, Dokploy, Railway, Fly.io — also works with this repository as-is.
Option 3: Node.js
Node 22 or newer:
npm ci
npm run build
npm startConfiguration
Variable | Required | Meaning |
| yes | The student's TAMO login |
| yes | Bearer token for clients that send headers, on |
| yes | Secret path for clients that only take a URL, on |
| if several roles | Terms joined with |
| no | Default |
| no | Default |
Generate the tokens with openssl rand -hex 32, or any password generator. /healthz answers without authentication, for uptime checks.
Connect your AI client
There are two addresses; use whichever your client supports:
URL only:
https://<your-server>/<MCP_PATH_TOKEN>/mcp, no authentication.URL + header:
https://<your-server>/mcpwith the headerAuthorization: Bearer <MCP_TOKEN>.
Claude (claude.ai, desktop and mobile apps): Settings → Connectors → Add custom connector. Paste the URL-only address. Connectors added on claude.ai also appear in the desktop and mobile apps.
ChatGPT: Settings → Apps & Connectors → Advanced settings → turn on Developer mode, then create a connector with the URL-only address and no authentication.
Claude Code:
claude mcp add --transport http tamo https://<your-server>/mcp --header "Authorization: Bearer <MCP_TOKEN>"Other clients (Cursor, VS Code, LibreChat…): add a Streamable HTTP MCP server with either address.
Then just ask about your homework, grades or schedule. Dates are interpreted in Europe/Vilnius time.
Development
npm ci
npm testThe TAMO endpoints this server uses are documented in the unofficial TAMO dienynas API reference.
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 AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Read your plat.plus courses, tasks, course pages, sessions, files and messages. Read-only.
Let your AI agent read and act on your Mail, Calendar, Contacts and more. Works with iCloud.
Email, calendar and contacts for AI agents: Gmail, Microsoft 365 and IMAP accounts behind one API.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceConnects AI agents to the École Directe API to access grades, homework, timetables, school life, messages, and documents.-
- AlicenseAqualityBmaintenanceEnables AI agents to query and manage EduPage school accounts, including timetables, grades, homework, meals, messages, multi-school discovery, role-aware student switching, and 2FA login.31131 PyPI4MIT
- AlicenseAqualityCmaintenanceLets an AI agent read and manage a family's EduPage school data, including timetables, homework, grades, messages, absences, events, and canteen meals, and also send messages to teachers or order meals.161MIT
- AlicenseNot gradedqualityBmaintenanceLets AI assistants query a family's school grades, absences, timetable, messages, trips, and calendar, and—after explicit human confirmation—report or justify absences, answer authorizations, reply to teachers, and book meetings.MIT