This guide walks you through connecting Achievator to Claude so your AI assistant can find projects, manage tasks, and help you stay on top of your work — all from within Claude.

How to connect

  1. 1

    Open Claude and go to settings

    In Claude, open the menu or profile area and look for Customize, Connectors, or Integrations — the exact label may vary slightly depending on your Claude version.

    Add screenshot: claude-add-custom-connector.webp

    Place the image in public/images/help/

    Claude's Add Custom Connector form
  2. 2

    Add a custom connector

    Select "Add Custom Connector" (or similar). Claude will show a form asking for a name and URL.
  3. 3

    Name it Achievator

    Enter "Achievator" as the connector name.
  4. 4

    Enter the MCP server URL

    Paste the following URL exactly:

    MCP server URL
    https://api.achievator.com/mcp
  5. 5

    Continue and click Connect

    Click Continue or Next, then click Connect. Claude will open an Achievator authorization page.
  6. 6

    Sign in to Achievator

    If you are not already signed in, enter your Achievator credentials. Your password is never shared with Claude.

    Add screenshot: claude-achievator-oauth.webp

    Place the image in public/images/help/

    Achievator OAuth authorization screen in Claude
  7. 7

    Select your workspace

    If you belong to multiple workspaces, choose the one you want Claude to access.
  8. 8

    Approve the requested permissions

    Review the scopes Achievator is requesting and click Approve (or Authorize). These define exactly what Claude can do.
  9. 9

    Return to Claude

    You will be redirected back to Claude. The Achievator connector should now show as connected.

    Add screenshot: claude-achievator-connected.webp

    Place the image in public/images/help/

    Achievator successfully connected in Claude
  10. 10

    Test the connection

    Try a prompt like: "Find my project named [your project name]." Claude should return results from your Achievator workspace.

Example prompts

  • “Find my project named Mobile App.”
  • “Show me open tasks in the Backend project.”
  • “Create a task: Set up CI/CD pipeline — add it to the DevOps project and schedule it for this week.”
  • “Rewrite the description for the task about API rate limiting with clearer implementation steps.”
  • “What tasks do I have due today?”

Add screenshot: claude-achievator-task-example.webp

Place the image in public/images/help/

A Claude conversation using Achievator to create a task

Troubleshooting

OAuth authorization page doesn't open

Allow pop-ups from Claude's domain in your browser settings. Try a different browser if the issue persists.

'Unknown client' or 'Invalid client' error

Remove the connector and re-add it using the exact URL: https://api.achievator.com/mcp — no extra characters or trailing slash.

403 Forbidden error during connection

Disconnect the connector, then reconnect and re-authorize. If it continues, contact support@achievator.com.

Need to reconnect or change workspace

In Achievator → Settings → Security → Connected Apps, revoke the Claude connection. Then reconnect from Claude and select the correct workspace.

Claude can see fewer actions than expected

The available actions depend on the scopes you approved during authorization. Revoke and reconnect if you need to re-authorize with the full scope set.