Freelo MCP

Freelo MCP connects your AI tool directly to Freelo. Instead of switching between tabs, you let ChatGPT, Claude, or Gemini list or create tasks, track time, or search comments — in natural language, in your own account.

What is Freelo MCP and why use it

MCP (Model Context Protocol) is an open standard that lets an AI tool and an external app communicate directly — without copying data between tabs and without pasting an API key into every chat. Think of it as a universal cable between AI and your tools.

👆 Freelo MCP in action – ChatGPT creates a task directly from chat, without copying data between tabs.

Freelo MCP means your AI assistant can read your projects, create tasks, watch deadlines, or track time. You stay in ChatGPT or Claude and type normally.

• The connection is free – you only pay your Freelo subscription and your AI tool plan.
• AI sees only what you have permission to see. No access to projects you have not been invited to.
• You can revoke access at any time – in Freelo settings or in the AI tool.

What you will need

The process is the same everywhere: (1) add a new connector in your AI tool, (2) enter the URL, (3) log in via Freelo OAuth, (4) enable the connector in chat and start asking.

Freelo MCP in ChatGPT (OpenAI)

Works on all plans including Free – we tested it. However, you must do the setup in a browser at chatgpt.com, not in the mobile or desktop app. Once set up, the connector also appears on mobile.

Step 1: Enable Developer mode

1. In the bottom left corner, click your photo or initials and select Settings.
2. In the sidebar, open Apps & Connectors (formerly "Connectors").
3. Scroll to the very bottom and click Advanced.
4. Toggle Developer mode to ON.
   

   

Step 2: Add Freelo as a custom connector

1. Back in Apps, click Create app (or Add custom connector – depending on your version).
2. Fill in:
   • Name: Freelo
   • Description (optional): My projects, tasks and time tracking in Freelo
   • MCP Server URL: https://mcp.freelo.io/mcp
   • Authentication: select OAuth
3. Check "I trust this application" and click Create.
   

   

Step 3: Connect via OAuth

1. Next to the Freelo connector, click Connect.
2. A panel opens at identity.freelo.io – log in with your Freelo email and password.
3. Approve the permissions. The connector switches to Connected ✅.
   

   

Step 4: Enable Freelo in chat

1. Open a new chat.
2. Next to the message field, click + → More → Developer mode.
3. Check Freelo.

Step 5: Try it out

Ask in natural language, as if talking to an assistant:

• "Show me my projects."
• "What do I have to finish today?"
• "Create a task 'Call Peter' in the Marketing project for tomorrow."
• "How many hours have I tracked this week?"

For actions that change something (creating a task, comment, work report) ChatGPT will show you a JSON preview of what it wants to do. Confirm with the Confirm button.

Freelo MCP in Claude (Anthropic)

The setup is identical on the claude.ai website and in the Claude desktop app – the UI is shared, so it does not matter where you start. If you prefer the terminal, see the separate Claude Freelo Skill – an alternative connection method via Claude Code.

Step 1: Add Freelo as a custom connector

1. Click your photo or initials and select Settings.
2. In the left sidebar: Customize → Connectors.
3. Click + → Add custom connector.
4. Fill in:
   • Name: Freelo
   • Remote MCP server URL: https://mcp.freelo.io/mcp
   • Fields under Advanced settings (OAuth Client ID / Secret) leave blank – Freelo handles this automatically.
5. Click Add.
   

   

Step 2: Connect via OAuth

1. Next to the Freelo connector, click Connect.
2. In the browser, log in at identity.freelo.io with your Freelo account.
3. Approve the permissions. The connector switches to Connected ✅.

Step 3: Enable Freelo in chat

1. Open a new chat.
2. Below the message field, click + → Connectors.
3. Enable Freelo.
   

   

Step 4: Try it out

The same prompts that work in ChatGPT work in Claude too. For actions that change something, Claude shows a preview and you confirm with the Allow button.

Freelo MCP in Gemini (Google)

We have to be honest here. The Gemini web app (gemini.google.com) does not yet support custom MCP connectors. No settings, no developer mode, no plan can do it – Free, AI Pro, or AI Ultra alike.

What Gemini has under Apps / Extensions is a closed list (Gmail, Calendar, Drive, GitHub, Spotify…) – Freelo cannot be added there manually yet.

Google can connect Freelo MCP only in two environments:

Gemini CLI – for the adventurous

1. Install Node.js (version 20 or higher) from nodejs.org.
2. In the terminal, install Gemini CLI:

   npm install -g @google/gemini-cli

3. Run it once with the command gemini and log in with your Google account.
4. Open the config file ~/.gemini/settings.json (on Mac in Finder: Cmd + Shift + G and paste the path) and add:

   {
     "mcpServers": {
       "freelo": {
         "type": "http",
         "url": "https://mcp.freelo.io/mcp"
       }
     }
   }

5. Restart CLI with the command gemini. On the first tool call, the CLI will walk you through OAuth login to Freelo in the browser.

Gemini Enterprise – IT admins only

The path goes through Google Cloud Console → Gemini Enterprise → Data Stores → Create → "Custom MCP Server (Preview)". It requires an OAuth client in a Cloud project and the Discovery Engine Editor IAM role.

If these terms mean nothing to you, this is not for you – go with Claude or ChatGPT.

❌ AI clients that do not support MCP

To be clear — these tools cannot connect to external MCP servers and have no plans to do so:

• Microsoft Copilot
• ChatGPT Web
• Gemini
• Perplexity
• NotebookLM
• Replit Ghostwriter
• GitHub Copilot (in IDE)

What to try first

A few prompts that quickly show you what Freelo MCP can do.

Work overview

• "Show me all my active projects."
• "What do I need to finish today?"
• "Which tasks are overdue?"

Creating and editing

• "Create a task 'Prepare presentation' in the Marketing project, deadline Friday, high priority."
• "Add a comment to the task 'Client onboarding' saying I called and we arranged a meeting for Monday at 9:00."
• "Mark the task 'API refactor' as done."

Time tracking and reports

• "Start tracking time on the task 'Code review'."
• "How many hours have I tracked this week on the project 'Web redesign'?"
• "Log a 90-minute work report on the task 'Client meeting' for today."

Search

• "Find all tasks with the word 'invoice' in the comments."
• "Which tasks are assigned to Peter and are overdue?"
  

  

Security and Freelo MCP permissions

Freelo MCP works like any other access to your account – it follows your permissions and you are in control.

• AI sees only what you have permission to see in Freelo. Projects you have not been invited to are invisible to AI too.
• Actions that change something require confirmation. AI shows you a preview (task creation, comment, deletion) and you confirm with a click.
• Authorisation via OAuth token. You can revoke it at any time directly in Freelo.
• No API keys shared anywhere. Login is handled by Freelo Identity.

How to revoke access

In Freelo: go to Settings → User account → Apps with access and click Revoke access next to Freelo MCP.

In individual clients:

• ChatGPT: Settings → Apps & Connectors → Freelo → Remove
• Claude: Settings → Customize → Connectors → Freelo → Disconnect
• Gemini CLI: remove the Freelo entry from ~/.gemini/settings.json

Troubleshooting

Frequently asked questions about Freelo MCP

Is the AI connection free?

Yes. The Freelo MCP server costs you nothing extra. You only pay your Freelo plan and your AI tool plan (ChatGPT, Claude, Gemini).

Does Freelo MCP work on the ChatGPT Free plan?

Yes, we tested it and Freelo MCP works on the ChatGPT Free plan – including write actions (creating tasks, comments, work reports).

Do I need Developer mode permanently enabled in ChatGPT?

Yes, if you want to use a custom MCP connector. If that condition bothers you, use Claude instead – there, MCP is a native part of the UI without any extra mode.

What if the OAuth dialog logs me in under the wrong account?

Open identity.freelo.io in the browser, click Log out, then in the AI client click Disconnect and Connect again. You will then log in with the correct account.

Can AI see other people's data in my Freelo?

No. Freelo MCP respects your permissions. AI cannot see projects you have not been invited to or tasks you do not have access to.

Can I use Freelo MCP on mobile?

Setup must be done in a browser (for ChatGPT) or in the desktop app (for Claude). After setup, the connector syncs and you can use it normally in the mobile apps.

What if AI does something wrong?

The same as any other mistake in Freelo – fix it manually. A deleted task can be found in Trash → Restore, a wrong comment can be edited or deleted, a work report can be corrected. We recommend always reviewing the preview before confirming any action that makes changes.

Practical Use

• Morning overview without a meeting - ask AI in one sentence what the team is working on and who has what overdue. A full overview in 30 seconds without opening Freelo.
• Meeting notes straight into tasks - paste your meeting notes into the chat and AI creates tasks with assigned owners and deadlines.
• Quick rescheduling - need to move an entire sprint or a group of tasks? Tell AI by how many days and it handles it, without manual clicking.
• Client reports - AI pulls tracked time from the logs and compiles a breakdown by project and by person, ready to share.
• Cross-project search - instead of browsing tabs, ask AI in natural language and get the result instantly.

Related articles

• Claude Freelo Skill – Control Freelo with AI – alternative connection via Claude Code in the terminal
• TuDů – AI assistant in Freelo – built-in AI assistant directly in the app
• API key – if you need access to Freelo outside MCP (Make, n8n, custom scripts)
• Freelo glossary – terms AI may ask you about

Further links

• ChatGPT – Developer mode for custom connectors: help.openai.com
• Claude – Custom connectors: support.claude.com
• Gemini CLI – MCP servers: geminicli.com/docs/tools/mcp-server