# IE Student MCP Free

**Your IE deadlines, readings, events and internship searches—in your existing AI assistant.**

Free early access to a local, read-only connector for **IE Blackboard**, **IE Connects** and **IE Careers (12twenty)**. Independent student-built software, not an official IE product.

**No subscription, product account, payment card, trial timer or telemetry.** The features in this Free edition are intended to remain free. Future paid features will be separate additions, not a timer on this release. Availability still depends on your IE permissions and the services remaining compatible.

## Try something useful

- “What Blackboard deadlines do I have this week? Show their sources.”
- “Find the readings and attachments for my next class.”
- “Which IE events am I registered for, and what is on my schedule?”
- “Find internships in Spain using the portal's actual filters.”
- “Show my grades and existing feedback.”
- “Find the officers and events of a student club.”

**49 tools** cover account setup, read/search queries, private attachment downloads, and local career search presets. [Complete tool reference](docs/tools.md) · [Free scope and limits](docs/free-scope.md).

## Choose your host and run one command

You need your own IE account, a compatible **local-MCP** assistant, a Chrome-family browser, [uv](https://docs.astral.sh/uv/getting-started/installation/), and [Git](https://git-scm.com/downloads). `uv` supplies Python 3.11 if needed. **You do not need GitHub access or a GitHub account.**

Run the command in your computer's terminal, not inside the AI chat. Choose **one** host:

### Antigravity — app and CLI together

```sh
uvx --from git+https://github.com/victor-gurbani/IEStudentMCP-Free.git@v1.0.0 ie-student-mcp-free setup --host antigravity
```

`antigravity-app` and `antigravity-cli` are aliases for the same shared configuration. Reload with `/mcp` in the CLI, or refresh **Settings → Customizations → Installed MCP Servers** in the app.

### Claude Desktop

```sh
uvx --from git+https://github.com/victor-gurbani/IEStudentMCP-Free.git@v1.0.0 ie-student-mcp-free setup --host claude-desktop
```

Quit and reopen Claude Desktop. The official desktop app is available on macOS and Windows.

### Claude Code

```sh
uvx --from git+https://github.com/victor-gurbani/IEStudentMCP-Free.git@v1.0.0 ie-student-mcp-free setup --host claude-code
```

Reload the MCP connections in Claude Code.

### Codex

```sh
uvx --from git+https://github.com/victor-gurbani/IEStudentMCP-Free.git@v1.0.0 ie-student-mcp-free setup --host codex
```

Reload the host's MCP connections or start a new session.

### OpenClaw

```sh
uvx --from git+https://github.com/victor-gurbani/IEStudentMCP-Free.git@v1.0.0 ie-student-mcp-free setup --host openclaw
```

OpenClaw must be installed locally. Setup uses its supported MCP command and probe; no gateway restart is requested.

### Another local host / manual setup

```sh
uv tool install --python 3.11 git+https://github.com/victor-gurbani/IEStudentMCP-Free.git@v1.0.0
ie-student-mcp-free config --host generic
```

Paste the generated non-secret JSON into your host's MCP settings. Its absolute interpreter path works even when a GUI does not inherit your shell's PATH.

The setup command creates a **persistent installation**, preserves unrelated host settings, makes private backups when changing a file, and only adds the `ie-student-free` entry. `--dry-run` previews setup. It does not overwrite an existing full `ie-student` entry; normally enable only one edition in a given host to avoid duplicate tool names.

## Connect your IE account

After reloading, ask your assistant:

> Use IE Student Free's `ie_get_started` and help me connect my IE accounts.

1. Discover browser profiles and check each service's sign-in status.
2. Choose your normal Chrome/Brave/Edge/Chromium profile, or an isolated persistent browser profile if normal-browser cookie extraction is unavailable.
3. Sign into IE/Microsoft **only in the local browser**. Passwords and MFA never belong in chat or MCP configuration.
4. Check sign-in again, then try a query. Routine reads never open browsers.

You can also use the terminal:

```sh
ie-student-mcp-free configure connects --source isolated
ie-student-mcp-free login connects
ie-student-mcp-free login connects --check
ie-student-mcp-free doctor
```

Repeat with `blackboard` or `careers` as needed. [Troubleshooting and updates](docs/setup.md).

## What is and is not included

| Included now and intended to stay free | Not in this public edition |
|---|---|
| Read/search your courses, deadlines, grades and feedback | Submitting coursework or changing academic records |
| Discover events, groups, people and schedules | Joining/leaving groups, registering for events, booking appointments |
| Search opportunities with live filters; read employers and resources | Applying for jobs, uploading CVs, changing portal profiles |
| Read existing messages, discussions and registrations | Sending messages, posting or changing portal favorites |
| Download supported attachments privately | Background hosted monitoring, paid features or billing |
| Save local career searches and run one-shot change previews | Creating native portal searches or enabling portal email alerts |

This is **not a hosted remote MCP URL**. It runs on the computer with your IE browser session. Hosting a website or using a cloud-only assistant does not provide that connection. Your assistant/model subscription, if any, is separate.

The connector has no developer-operated data backend. Browser sessions stay local, but results are passed to your chosen AI host, which may process them on its provider's servers. Only request information you are comfortable sharing with that host.

## Downloads, feedback and verification

[Download the latest release](https://github.com/victor-gurbani/IEStudentMCP-Free/releases/latest): wheel, source archive and SHA-256 checksums. The wheel bundles the three read-only clients; no private Git dependencies or premium action modules are included. A wheel installation needs public Python dependencies, not Git or access to the development repositories.

[Report a bug or suggest an improvement](https://github.com/victor-gurbani/IEStudentMCP-Free/issues). Everyone can suggest improvements. Share the version, OS, host and a **redacted error category**, never cookies, passwords, MFA, transcripts, CVs or private student records. Early-access feedback is welcome; no response-time guarantee is implied.

Protocol, packaging, host-config and boundary tests run on Windows/macOS/Linux with Python 3.11/3.13. Automated checks are not proof of every host's visual UI or of a new user's SSO/MFA flow. IE can deny some endpoints to a student role; empty/restricted results are not bypassed. Read pagination and truncation warnings before assuming a result is complete.

Source is published without the private repositories' history. See [license terms](LICENSE) and [component notices](THIRD_PARTY_NOTICES.md); the bundle is source-available, not uniformly MIT-licensed.