Our review
Generates music via the Suno AI API from textual descriptions, custom lyrics, or specific style tags.
Strengths
- Quick generation of original songs from a simple description
- Supports custom lyrics and instrumental-only tracks
- Style tags (genre, voice, mood) to refine the output
- Free tier available with 50 credits per day
Limitations
- Authentication token expires every hour and must be manually refreshed
- Limited number of songs per day (5 on free plan)
- No fine-grained control over mixing or mastering
When you need a quick draft or demo of a song, background music, or jingle with a specific mood or lyrics.
For professional music production requiring precise mixing, mastering, or long-term iterative composition, or when reliable offline generation is needed.
Security analysis
SafeThe skill uses a Bash command to invoke a local Python script that interacts with Suno AI's API using a session cookie obtained manually by the user. There are no destructive commands, exfiltration, or obfuscation. The token handling is entirely local and standard for API usage. No elevated risk beyond normal API interaction.
No concerns found
Examples
Create a pop song with the following lyrics about summer: 'Sun is high, sky is blue, feeling like there's nothing we can't do' – make it upbeat and include a female voice.Generate an instrumental electronic track that sounds futuristic and energetic, suitable for a tech product launch.Make a song that sounds like a melancholic indie folk ballad, with male vocals and acoustic guitar.name: suno-music description: Generate music using AI. Use when the user asks to create, generate, or make music, songs, audio, melodies, tracks, or beats. Supports custom lyrics, instrumental-only, and style tags. allowed-tools: Bash, Read, Write
Suno Music - AI Music Generation
Generate music using Suno AI's API.
Setup (One-Time)
- Sign in to suno.ai
- Open browser DevTools (F12) → Console tab
- Run:
document.cookie - Find the
__session=eyJ...part (it's a long JWT token) - Export it:
export SUNO_COOKIE="__session=eyJ..."
Note: The __session token expires after ~1 hour. You'll need to refresh it periodically.
Usage
Run the generation script:
python3 ~/.claude/skills/suno-music/generate_music.py "your prompt here" [options]
Options
| Option | Description | Default |
|--------|-------------|---------|
| --custom | Treat prompt as lyrics (not description) | False |
| --tags | Style/voice tags (e.g., "female voice, pop, upbeat") | None |
| --title | Song title | None |
| --instrumental | Generate instrumental only (no vocals) | False |
| --output | Output directory path | ./generated_music |
| --model | Model key (e.g., chirp-auk-turbo) | Default free model |
Examples
Generate from description
python3 ~/.claude/skills/suno-music/generate_music.py "an upbeat electronic track for a tech product demo"
Custom lyrics with style
python3 ~/.claude/skills/suno-music/generate_music.py "[Verse 1]
Walking through the morning light
Everything feels just right" --custom --tags "indie folk, acoustic guitar, male voice" --title "Morning Light"
Instrumental track
python3 ~/.claude/skills/suno-music/generate_music.py "epic orchestral trailer music with building tension" --instrumental
Output
Songs are saved with format: {timestamp}_{sanitized_title}_{n}.mp3
Example: 20260106_morning_light_1.mp3
Suno generates 2 variations per request by default.
Credits
- Free tier: 50 credits/day (renews daily)
- Each generation uses 10 credits (5 per song × 2 variations)
- So you can generate 5 songs per day on the free tier
Check remaining credits:
python3 ~/.claude/skills/suno-music/generate_music.py --credits
Models
| Model | Key | Notes | |-------|-----|-------| | v4.5-all | chirp-auk-turbo | Best free model (default) | | v5 | chirp-crow | Pro only, beta | | v4.5+ | chirp-bluejay | Pro only | | v4 | chirp-v4 | Pro only |
Requirements
- Python 3.x
requestslibrary (usually pre-installed)SUNO_COOKIEenvironment variable with__sessiontoken
Troubleshooting
"API Error: 401" - Token expired. Get a fresh __session token from the browser.
"API Error: 402" - Out of credits. Wait for daily refresh or upgrade.
Content Repurposer
Content
Transforms a single piece of content into platform-adapted publications.
SEO Blog Post Writer
Content
Writes SEO-optimized blog posts with proper structure and keywords.
YouTube Script Writer
Content
Writes engaging YouTube scripts with hooks, structure, and retention.