@goalswon/mcp-server

Connect AI assistants (Claude, Cursor, Gemini, etc.) to your GoalsWon data via the Model Context Protocol.

Quick Start

With Claude Code

claude mcp add goalswon -- npx @goalswon/mcp-server

Then set your API key as an environment variable:

export GOALSWON_API_KEY=gw_your_key_here

Manual Setup

npx @goalswon/mcp-server

Required environment variables:

| Variable | Description | |----------|-------------| | GOALSWON_API_KEY | Your GoalsWon API key (generate at Settings > API Access) | | GOALSWON_API_URL | API base URL (default: https://api.goalswon.com) |

Available Tools (39)

Read:

| Tool | Description | |------|-------------| | get_profile | Your profile, coach name, and counters | | list_goals | List goals by date and status | | get_goal | Get a single goal | | get_day | Day detail with goals and summary | | list_days | List day submissions | | list_months | List month submissions | | get_month | Month detail with targets | | list_targets | Monthly targets by month and status | | get_target | Get a single target | | list_yearly_targets | Yearly targets with reflections | | get_yearly_target | Yearly target with linked monthly targets | | list_inbox | Inbox items | | list_wins | Wins | | list_recurring_goals | Recurring goal templates | | get_recurring_goal | Single recurring goal detail | | get_progress | Completion rates, streaks, and trends | | search_chat | Search chat message history |

Write:

| Tool | Description | |------|-------------| | create_goal | Create a goal | | update_goal | Update a goal | | complete_goal | Mark done, partial, or pending. Accepts date for recurring goals. | | delete_goal | Delete a goal | | create_recurring_goal | Create a recurring goal | | update_recurring_goal | Update a recurring goal | | delete_recurring_goal | Delete a recurring goal | | create_target | Create a monthly target | | update_target | Update a monthly target | | delete_target | Delete a monthly target | | create_yearly_target | Create a yearly target | | update_yearly_target | Update a yearly target | | delete_yearly_target | Delete a yearly target | | create_inbox_item | Add to inbox | | update_inbox_item | Update an inbox item | | schedule_inbox_item | Convert inbox item to a goal | | delete_inbox_item | Delete an inbox item | | submit_day | Submit a day — rolls undone goals to next day | | unsubmit_day | Unsubmit a day — deletes rolled goals. Use before modifying submitted days. | | submit_month | Submit a month's results | | unsubmit_month | Unsubmit a month | | send_message | Send a chat message |

Get an API Key

1. Go to app.goalswon.com
2. Settings > API Access
3. Enable Read access (and Write/Chat if needed)
4. Generate a key

License

MIT