Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

# College Deadlines MCP Server

A Model Context Protocol (MCP) server that scrapes VTOP digital assignments and creates iPhone reminders for deadlines.

## Purpose

This MCP server provides a secure interface for AI assistants to fetch college assignment deadlines from VTOP (VIT Online Portal) and automatically create reminders in iPhone's native Reminders app.

## Features

### Current Implementation
- **`set_session_cookie`** - Store VTOP session cookie for authentication
- **`fetch_digital_assignments`** - Scrape all digital assignments from VTOP
- **`due_today`** - Filter assignments due today based on timezone
- **`create_reminders_batch`** - Create iPhone reminders for assignments due today
- **`list_all_assignments`** - Display all fetched assignments with details

## Prerequisites

- Docker Desktop with MCP Toolkit enabled
- Docker MCP CLI plugin (`docker mcp` command)
- macOS (for iPhone Reminders integration)
- Valid VTOP session cookie (JSESSIONID)
- Access to VTOP portal

## Installation

See the step-by-step instructions provided with the files.

## Usage Examples

In Claude Desktop, you can ask:
- "Set my VTOP cookie: [paste cookie here]"
- "Fetch my digital assignments from VTOP"
- "Show me assignments due today"
- "Create iPhone reminders for today's assignments in my College list"
- "List all my assignments with details"

## Getting Your VTOP Cookie

1. Login to VTOP in your browser
2. Open Developer Tools (F12)
3. Go to Application/Storage → Cookies
4. Find and copy the JSESSIONID value
5. Use it with set_session_cookie tool

## Architecture

About

A MCP server which is integrated with claude desktop and adds the functionality of accessing my college website - logging into my portal bypassing all captchas- navigate to my digital assignments section- and fetches my digital assignments for me and creates an apple reminder for me for the latest due assignments.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages