Content
# mcp-server-systemeio
MCP Server for [Systeme.io](https://systeme.io) — manage your online business from Claude.


## What it does
Gives Claude direct access to your Systeme.io account — contacts, tags, courses, subscriptions, and more. Instead of switching between Claude and your Systeme.io dashboard, just ask in natural language: "show me my recent contacts", "tag this person as VIP", or "enroll them in my course".
Built for solopreneurs, freelancers, and creators who run their business on Systeme.io.
## Tools
| Tool | Description |
|------|-------------|
| `list_contacts` | List and filter contacts (by email, tags, status, date) |
| `get_contact` | Get full details of a contact |
| `create_contact` | Create a new contact with email, locale, and custom fields |
| `update_contact` | Update a contact's locale or custom fields |
| `delete_contact` | Delete a contact |
| `list_tags` | List all tags (with search) |
| `create_tag` | Create a new tag |
| `update_tag` | Rename a tag |
| `delete_tag` | Delete a tag |
| `add_tag_to_contact` | Assign a tag to a contact (can trigger automations) |
| `remove_tag_from_contact` | Remove a tag from a contact |
| `list_contact_fields` | List all custom contact fields |
| `list_courses` | List online courses in your school |
| `enroll_contact_in_course` | Enroll a contact in a course (full, partial, or dripping access) |
| `list_enrollments` | List all course enrollments |
| `remove_enrollment` | Remove a course enrollment |
| `list_subscriptions` | List payment subscriptions for a contact |
| `cancel_subscription` | Cancel a subscription |
## Quick Start
### 1. Get your API key
Go to your [Systeme.io dashboard](https://systeme.io) → **Profile** → **Public API keys** → Generate a new key.
> The free plan works! You get 2,000 contacts, 3 funnels, 1 course, and unlimited emails at no cost.
### 2. Install
```bash
git clone https://github.com/snzeeee/mcp-server-systemeio.git
cd mcp-server-systemeio
npm install
```
### 3. Configure
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
```json
{
"mcpServers": {
"systemeio": {
"command": "node",
"args": ["/path/to/mcp-server-systemeio/src/index.js"],
"env": {
"SYSTEMEIO_API_KEY": "your-api-key-here"
}
}
}
}
```
On Windows, the config file is at `%APPDATA%\Claude\claude_desktop_config.json`.
### 4. Restart Claude Desktop
Close and reopen Claude Desktop. The Systeme.io tools will appear automatically.
## Examples
**"Show me my last 20 contacts"**
→ Claude calls `list_contacts` with limit 20 and returns a formatted list.
**"Find contacts tagged VIP"**
→ Claude calls `list_tags` to find the VIP tag ID, then `list_contacts` filtered by that tag.
**"Create a contact for john@example.com and tag them as Lead"**
→ Claude calls `create_contact`, then `add_tag_to_contact` to assign the tag.
**"Enroll contact #12345 in my course"**
→ Claude calls `list_courses` to find the course, then `enroll_contact_in_course`.
**"What courses do I have?"**
→ Claude calls `list_courses` and shows active courses with details.
## Requirements
- Node.js 18+
- [Systeme.io](https://systeme.io) account (free plan works)
## Author
Built by [snzeeee](https://github.com/snzeeee)
## License
MIT