← Support

CertainGoal Connector for Claude

Last updated: June 19, 2026

The CertainGoal connector lets Claude work with your goals directly in a conversation. Once connected, you can ask Claude to list your goals with live status and progress, open a goal's KPIs and tasks, create and update goals, and summarize a whole project's health — all scoped to your own account.

What it does

The connector exposes a small set of tools mapped to your CertainGoal data. It is read, create, and update only — it never deletes anything, and every request runs under your own identity with database row-level security, so it can only ever see and change your data.

Requirements

• A free CertainGoal account (sign up with Google or email).
• A Claude client that supports custom connectors (Claude.ai web or Claude Desktop).
• No paid plan, admin seat, custom instance, or special configuration is required. Available globally.

Connecting in Claude

Add the connector using your MCP server URL:

https://app.certaingoal.com/api/mcp

1. In Claude, go to Settings → Connectors → Add custom connector.
2. Paste the URL above and continue.
3. You'll be redirected to a hosted login. Sign in with the same email you use for CertainGoal and authorize access.
4. The CertainGoal tools then appear and are ready to use in a conversation.

Authentication

The connector uses OAuth 2.1 (Authorization Code + PKCE) with Dynamic Client Registration — your Claude client registers itself automatically; there is nothing to copy or paste. Authentication is handled by our processor, WorkOS. Each request verifies your access token and runs against a short-lived, user-scoped database session; no long-lived credentials are stored. You can revoke access at any time from Claude's connector settings.

Available tools

Tool	What it does
list_goals	List your goals (optionally within one project) with derived status (not started / in progress / done / overdue), progress %, and deadline. Paginated. Read-only.
get_goal	Full detail for one goal: description, metric, deadline, derived status & progress, its KPIs, and its child tasks. Read-only.
create_goal	Create a new goal in a project (title, optional description, deadline, metric, color).
update_goal	Partially update a goal — title, description, deadline, metric, color, or progress formula. Only the fields you pass change.
list_tasks	List tasks across a goal or a project, optionally filtered by status or priority. Paginated. Read-only.
create_task	Add a task under a goal (description, optional why, status, priority, dates, estimate). Tasks drive a goal's derived progress.
update_task	Partially update a task — set its status (e.g. done to complete, discarded to drop), priority, dates, or text. No hard delete.
get_project_summary	Project health: total goals, counts by status, % complete, overdue count, and a task-level status breakdown. Read-only.

status and progress are derived from a goal's tasks and are read-only. The connector performs no deletions.

Example prompts

• "List my CertainGoal goals and tell me which are overdue."
• "Open my 'Launch MVP' goal and show its tasks and KPIs."
• "Create a goal 'Hit 500 signups' in my crtnGrow project, due 2026-09, with metric '500 signups'."
• "Push my 'Launch MVP' goal's deadline to next month."
• "Give me a health summary of my crtnGrow project."

Troubleshooting

• The tools don't appear after connecting. Make sure the URL is exactly https://app.certaingoal.com/api/mcp, then remove and re-add the connector so it re-runs the OAuth flow.
• Login succeeds but no goals show. The connector maps to your account by email. Sign in with the same email you use in the CertainGoal app, and confirm that account has goals (create one at app.certaingoal.com).
• Asked to re-authenticate repeatedly. Disconnect the connector in Claude's settings and add it again to obtain a fresh authorization.
• A project-scoped request fails. Use a valid project id from list_goals or get_goal output when asking for project-specific actions.
• Still stuck? Email contact@certaingoal.com with what you asked and what Claude returned.

Data & privacy

The connector accesses your goals, tasks, KPIs, and projects only at your direction, and only for your own account. Data you ask about is shared with Claude (Anthropic) only as needed to answer your request. See our Privacy Policy for details, including the AI assistants & connectors section.

Support

Questions or issues? Email contact@certaingoal.com.