Northeastern University Calendar MCP Server

This MCP server provides access to Northeastern University's event calendar through the Model Context Protocol (MCP). It allows Claude Desktop to fetch, search, and filter events from the Northeastern University calendar.

Features

Get today's events
Get upcoming events for a specified number of days
Search events by keywords
Filter events by category
Get detailed information about specific events
List available event categories

Requirements

Python 3.9+
Claude Desktop app
Internet connection to access the Northeastern University calendar

Installation

Clone or download this repository
Create a virtual environment:

python -m venv venv

Activate the virtual environment:
- On macOS/Linux:
```
source venv/bin/activate
```
- On Windows:
```
venv\Scripts\activate
```
Install the required dependencies:

pip install -r requirements.txt

Usage

Running the MCP Server

Make sure your virtual environment is activated
Start the server:

python neu_calendar_server.py

The server will start on localhost port 8000 by default

Connecting to Claude Desktop

For detailed instructions on setting up the MCP server with Claude Desktop, see CLAUDE_DESKTOP_SETUP.md.

Quick setup:

Open Claude Desktop
Go to Settings -> Developer
Click "Edit Config"
Add the configuration for the NEU Calendar MCP server
Restart Claude Desktop

Using the Extension

Once the extension is installed and the server is running, you can ask Claude about Northeastern University events. For example:

"What events are happening today at Northeastern University?"
"Show me upcoming events for the next week"
"Are there any workshops happening this month?"
"Tell me about athletic events at Northeastern"
"What categories of events are available?"

Screenshots

Here are some examples of the NEU Calendar MCP server in action:

Available MCP Tools

The NEU Calendar MCP server provides several tools for interacting with the Northeastern University calendar.

Sample Query

Example of a simple query asking about upcoming events at Northeastern University.

Category Search - Sports Events

Claude searching and displaying upcoming sports events from the Northeastern University calendar.

Detailed Information Request

Claude providing detailed information about specific events based on a selected event. In the above case, it identified that the event is about Claude itself. 🙂

Tool Usage Permission

Claude asking for permission before executing a calendar search tool.

Troubleshooting

If Claude can't connect to the server, make sure the server is running and that the port (8000) is not blocked by a firewall
If the server can't fetch the calendar data, check your internet connection
If Claude Desktop reports an extension configuration error, verify that the configuration is correct

License

This project is provided for educational purposes. Calendar data belongs to Northeastern University.

Credits

Calendar data source: Northeastern University Calendar
Built using the Model Context Protocol (MCP)