# Elvanto MCP by usefulapi

> Elvanto MCP by usefulapi is an MCP server. Look up people, groups, service rosters, songs, follow-up flows and giving in Elvanto. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/elvanto/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/elvanto
- **MCP Registry name:** io.usefulapi/elvanto
- **Listing updated:** 2026-11-13

## About

Look up people, groups, service rosters, songs, follow-up flows and giving in Elvanto.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http elvanto https://elvanto.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://elvanto.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "elvanto": {
      "url": "https://elvanto.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "elvanto": {
      "type": "http",
      "url": "https://elvanto.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "elvanto": {
      "serverUrl": "https://elvanto.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "elvanto": {
      "type": "http",
      "url": "https://elvanto.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `elvanto_list_people`: List people in the church database, optionally filtered by category and by suspended / contact / archived status. Paginated (the response carries page, per_page, total). Elvanto: people/getAll.
- `elvanto_search_people`: Find people matching field values, e.g. {"email":"john@example.com"} or {"lastname":"Smith","volunteer":"yes"}. Searchable keys: firstname, preferred_name, lastname, email, phone, mobile, category_id, archived, contact, deceased, volunteer, gender, birthday, anniversary, marital_status, school_grade, security_code, receipt_name, giving_number, groups, date_added / date_modified / last_login (UTC, 
- `elvanto_get_person`: Fetch one person by id, optionally with extra fields (birthday, addresses, departments, locations, family, custom fields...). Elvanto: people/getInfo.
- `elvanto_list_people_categories`: List the people categories (e.g. New People, Church Members, Inactive) with their ids. Elvanto: people/categories/getAll.
- `elvanto_list_custom_fields`: List the church's custom person fields (id, name, type and allowed values). Use the id as custom_<id> in fields / search. Elvanto: people/customFields/getAll.
- `elvanto_list_groups`: List small groups / ministries with meeting day, time, place and frequency; add fields=["people"] to include members and leaders. Elvanto: groups/getAll.
- `elvanto_get_group`: Fetch one group by id, optionally with its members (fields=["people"]). Elvanto: groups/getInfo.
- `elvanto_list_services`: List services (upcoming by default). Add fields such as volunteers (the roster), plans (order of service) and songs to answer 'who is serving Sunday?' or 'what are we singing?'. Elvanto: services/getAll.
- `elvanto_get_service`: Fetch one service by id with optional detail: service/rehearsal times, plan (order of service), volunteers roster, songs, files, notes. Elvanto: services/getInfo.
- `elvanto_list_songs`: List or search the song library by title, artist or lyrics (with CCLI number, categories and locations). Elvanto: songs/getAll.
- `elvanto_list_song_arrangements`: List the arrangements of one song — sequence, BPM, keys, lyrics and chord chart (optionally transposed). Elvanto: songs/arrangements/getAll.
- `elvanto_list_calendars`: List the church's calendars with their ids. Elvanto: calendar/getAll.
- `elvanto_list_calendar_events`: List calendar events between two dates, optionally for specific calendars (use "services" as a calendar to include services). Elvanto: calendar/events/getAll.
- `elvanto_list_people_flows`: List people flows — the church's follow-up pipelines (e.g. First Time Guest Follow Up) — with their steps and admins. Elvanto: peopleFlows/getAll.
- `elvanto_list_people_flow_steps`: List the steps of one people flow with descriptions, instructions, due rules and admins. Elvanto: peopleFlows/steps/getAll.
- `elvanto_list_people_flow_step_people`: List the people currently in one people-flow step, with status, due date and assigned admin — e.g. who still needs a follow-up call. Not paginated. Elvanto: peopleFlows/steps/people.
- `elvanto_list_financial_categories`: List giving / chart-of-accounts categories (funds) with ids; status 1 = active, 0 = archived. Elvanto: financial/categories/getAll.
- `elvanto_list_transactions`: List giving transactions between two dates, optionally for one fund — donor, date, method, batch and per-fund amounts. Read-only: this server never writes financial records. Elvanto: financial/transactions/getAll.
- `elvanto_create_person`: Add a new person to the church database (e.g. a first-time guest). Returns the new person id and family id. Does not create a login. Elvanto: people/create.
- `elvanto_update_person`: Edit an existing person's details — name, contact info, category, flags, family, or extra fields. Only the fields you pass change. Cannot touch username, password or login status. Elvanto: people/edit.
- `elvanto_add_person_to_group`: Add a person to a group, optionally as Leader or Assistant Leader. Undoable by removing them from the group in Elvanto. Elvanto: groups/addPerson.
- `elvanto_add_person_to_flow_step`: Put a person into a people-flow step (e.g. start a new guest's follow-up), optionally assigning a step admin. Elvanto: peopleFlows/steps/addPerson.
- `elvanto_create_calendar_event`: Create an event on a calendar, optionally repeating. Times are 24-hour GMT. Use status "draft" to stage it unpublished. Elvanto: calendar/events/create.

## FAQ

### How do I add Elvanto MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http elvanto https://elvanto.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/elvanto-mcp-by-usefulapi
