API & Integrations

Pro users can access Gigmeister data programmatically via REST API and Model Context Protocol (MCP).

For detailed endpoint documentation with request/response schemas, see the API Reference.

REST API

Generate API keys to access your band’s data from external tools.

Getting an API Key

1. Go to Settings > Advanced > API
2. Click Generate New Key
3. Give your key a name (e.g., “Automation Script”)
4. Copy the key — it’s only shown once!

API keys use the format gig_xxxxxxxxxxxx.

Authentication

Include your API key in the Authorization header:

curl -H "Authorization: Bearer gig_your_api_key" \
  https://gigmeister.app/api/songs

Rate Limits

• 100 requests per minute per API key
• Rate limit headers included in responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Response Format

All responses use a consistent envelope:

{
  "ok": true,
  "data": { ... }
}

Error responses:

{
  "ok": false,
  "error": "Description of what went wrong"
}

Usage Tracking

View request counts per key from Settings > Advanced > API — broken down by endpoint, day, and month.

Endpoints

Songs

Method	Path	Description
GET	/api/songs	List all songs
POST	/api/songs	Create a song
GET	/api/songs/:id	Get a song
PATCH	/api/songs/:id	Update a song
DELETE	/api/songs/:id	Delete a song
POST	/api/songs/import	Bulk import (up to 100)
GET	/api/songs/duplicates	Find potential duplicates
POST	/api/songs/merge	Merge two duplicates

Setlists

Method	Path	Description
GET	/api/setlists	List all setlists
POST	/api/setlists	Create a setlist
GET	/api/setlists/:id	Get a setlist with songs
PATCH	/api/setlists/:id	Update a setlist
DELETE	/api/setlists/:id	Delete a setlist
POST	/api/setlists/:id/songs	Add songs to a setlist
DELETE	/api/setlists/:id/songs	Remove a song
PUT	/api/setlists/:id/songs/reorder	Reorder songs

Song Groups

Method	Path	Description
GET	/api/song-groups	List all groups
POST	/api/song-groups	Create a group
GET	/api/song-groups/:id	Get a group
PATCH	/api/song-groups/:id	Update a group
DELETE	/api/song-groups/:id	Delete a group

Calendar Events

Method	Path	Description
GET	/api/calendar/events	List events
POST	/api/calendar/events	Create an event
GET	/api/calendar/events/:id	Get an event with attendance
PATCH	/api/calendar/events/:id	Update an event
DELETE	/api/calendar/events/:id	Delete an event
POST	/api/calendar/events/:id/attendance	Set attendance status

Band

Method	Path	Description
GET	/api/band	Get band info
GET	/api/band/members	List members

Practice

Method	Path	Description
GET	/api/practice/practice-sessions	Get practice history
POST	/api/practice/practice-sessions	Log a practice session

OpenAPI Spec

A machine-readable OpenAPI 3.0 specification is available at /api/openapi. Use it with tools like Swagger UI, Postman, or code generators.

Example: List Songs

curl -s -H "Authorization: Bearer gig_your_api_key" \
  https://gigmeister.app/api/songs | jq '.data[0]'

{
  "id": "uuid",
  "title": "Don't Stop Believin'",
  "artist": "Journey",
  "key": "E",
  "tempo": 119,
  "duration": 251,
  "timeSignature": "4/4",
  "tags": ["80s", "opener"]
}

Example: Create a Song

curl -X POST -H "Authorization: Bearer gig_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"title": "Sweet Child O Mine", "artist": "Guns N Roses", "key": "D", "tempo": 128}' \
  https://gigmeister.app/api/songs

MCP (Model Context Protocol)

Connect AI assistants like Claude Desktop to Gigmeister via MCP.

What is MCP?

MCP allows AI tools to read and manage your song library, create setlists, and more — all through natural language.

Configuration

1. Go to Settings > Advanced > MCP
2. Copy the MCP configuration
3. Add it to your AI assistant’s MCP settings

Capabilities

With MCP connected, you can ask your AI assistant to:

• “List all songs in my library”
• “Create a setlist for Saturday’s gig”
• “Find songs in the key of G”
• “Add a new song with these chord changes”

AI Features

Built-in AI features (Pro) include:

Feature	Description
Generate Setlist	Create a setlist from a text prompt
Chord Sheet Generation	Convert text to formatted chord sheets
Lyrics Lookup	Fetch lyrics for songs automatically
Medley Matching	Find songs that work well together
Setlist Optimization	Reorder for better flow
Metadata Inference	Auto-fill key, tempo from text

Access these features from the relevant screens in the app.