Habitica MCP Server

由你的代理程式管理 Habitica 中的習慣、每日任務和待辦事項。

託管 MCP 伺服器

npx add-mcp 'https://cotlet.dev/mcp/v1/habitica'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

Cotlet · All integrations · MCP servers · APIs · API & MCP status · How it works · Security · Custom API · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Habitica MCP server · unofficial, by Cotlet Let your AI agent work in your Habitica account.

Cotlet is a cloud browser that stays signed in to your Habitica account, so ChatGPT, Claude or any AI agent can work in it. Free 7-day trial, no card.

Source: https://cotlet.dev/integrations/habitica-api-mcp-server

Cotlet is a cloud browser with a remote MCP server. It stays signed in to your Habitica account, so ChatGPT, Claude or any MCP client can work on the same screens you use: tasks, party, challenges and inventory.

Try it free now

How to connect

  • Free 7-day trial, no card
  • Unofficial, not affiliated with Habitica

Server URL

https://cotlet.dev/mcp/v1

Connection

Streamable HTTP · OAuth or API key

Works in

ChatGPT, Claude, Claude Code, Cursor, Codex, n8n

Habitica facts on this page were checked on 20 Nov 2026.

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Habitica. Habitica is a trademark of its owner. If Habitica's own integrations cover what you need, use them first.

Six habit jobs

What can you ask your agent to do in Habitica? Whatever your own login can do by hand.

  • These 4 to-dos repeat every week. Make each one a daily on its days, and ask me before you delete the old ones.

  • Add these 5 to-dos from my notes, each with a checklist.

  • Which dailies are due today and not ticked yet?

  • Tag every to-do about work with Work.

  • Post in my party chat that I am away until Monday.

  • Which to-dos have been open for more than a month?

Remote MCP server

How does the Habitica MCP server from Cotlet work?

Cotlet runs a remote MCP server that gives your AI agent a Cloud Browser: a Chrome that runs in the cloud and stays signed in to your Habitica account. Your AI client connects to the server and gets browser tools from it. Before its first step in Habitica, the agent reads Cotlet's guide to Habitica's screens. Then it opens habitica.com in your Cloud Browser and works on the same screens you use.

  1. YOUR AI ChatGPT, Claude, Cursor, n8n or any MCP client
  2. COTLET MCP SERVER https://cotlet.dev/mcp/v1 Streamable HTTP · OAuth or API key
  3. YOUR CLOUD BROWSER Chrome in the cloud, signed in as you
  4. HABITICA habitica.com

Habitica MCP server from Cotlet

WhatAnswer
Server URL with OAuth sign-inhttps://cotlet.dev/mcp/v1/connect for ChatGPT, Claude, Claude Code and Grok
Server URL with an API keyhttps://cotlet.dev/mcp/v1 for Codex, Cursor, Hermes Agent, n8n and other MCP clients
TransportStreamable HTTP
Tools your agent getsBrowser tools to open, read, click, type, select, fill in forms, scroll, take screenshots and download files, plus a guide to Habitica's screens
Where Habitica runsYour Cloud Browser, signed in with your own Habitica login
What Cotlet storesThe signed-in session, encrypted. No password
StatusUnofficial. Cotlet is not affiliated with Habitica

Claude Code

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1/connect

The same server and the same tools work in any web app you sign in to. Habitica is one of them.

Set up once

How to connect Habitica to your AI agent Three steps, no code.

You need your own Habitica login, access to any sign-in code Habitica sends you, and a Cotlet account. The free trial gives you 2,000 credits for 7 days, no card.

  1. Step 1

Sign in to Habitica

Your account, in your Cloud Browser. 2. Step 2

Connect your AI agent

Add the Cotlet server to ChatGPT, Claude or another client. 3. Step 3

Ask for a first job

Your agent asks before it deletes, buys or posts.

We never see your Habitica password, and deletions, purchases and party posts wait for your OK. Who can see your session

On this page

Any MCP client

Connect Habitica to your AI agent

Step 1: sign in to Habitica in your Cloud Browser

In the Cotlet console, open your Cloud Browser, go to habitica.com and sign in with your usual email and password. If Habitica asks for a code, you enter it there yourself.

You type the password into Habitica's own page. Cotlet does not see it and does not store it; it keeps only the signed-in session, encrypted. If Habitica signs you out one day, your agent says so and sends you a link to sign in again.

Step 2: connect your AI agent

Pick the AI you already use. ChatGPT, Claude, Claude Code, Codex, Cursor, Grok, Hermes Agent, n8n and other MCP clients all work in the same signed-in Habitica account.

ChatGPTchatgpt.com and its apps Claudeclaude.ai and desktop app Claude Codeone terminal command Codexone entry in config.toml Cursorone entry in mcp.json Grokgrok.com connectors Hermes Agentone block in config.yaml n8nMCP Client node Any MCP clientOpenClaw and others

Pick your AI above to see its steps.

How to connect Habitica to ChatGPT

Do this on chatgpt.com in your browser. Cotlet then works in the ChatGPT desktop and phone apps too.

  1. Open Plugins in ChatGPT and click Add.
  2. Click Add custom MCP server. Not in the menu? Turn on Developer mode in Settings, Security and login, then come back.
  3. Paste the name Cotlet and the server URL https://cotlet.dev/mcp/v1/connect. Keep Authentication on OAuth.
  4. Tick "I understand and want to continue" and click Create as a plugin.
  5. Click Connect Cotlet. A Cotlet page opens, click Allow access.
  6. In a new chat, type @Cotlet and pick it from the list.
  7. Ask ChatGPT: "Are you signed in to Cotlet through MCP?" Then try a first Habitica task: "List my Habitica dailies that are not ticked yet today."

ChatGPT asks "Allow ChatGPT to use Cotlet?" before some steps. Pick Always allow, or the chat waits for your click. On a Business, Enterprise or Edu workspace, an admin has to allow custom MCP servers first.

How to connect Habitica to Claude

  1. Open Connectors in Claude and click Add. In the desktop app it is under Customize, Connectors.
  2. Click Add custom connector.
  3. Paste the name Cotlet and the URL https://cotlet.dev/mcp/v1/connect, then click Continue.
  4. Keep the settings and click Add.
  5. A Cotlet page opens. Click Allow access.
  6. In a chat, click the plus button, then Connectors, and turn Cotlet on.
  7. Ask Claude: "Are you signed in to Cotlet through MCP?", then "Which Habitica to-dos have been open for more than a month?". Claude asks before it uses a Cotlet tool the first time. Click Allow.

Claude's free plan allows one custom connector. On a Team or Enterprise plan, an owner adds Cotlet in Organization settings, Connectors, and you click Connect next to it.

How to connect Habitica to Claude Code

Add Cotlet without a key, then sign in once in the browser:

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1/connect

Run /mcp in Claude Code, pick cotlet and sign in to Cotlet. Prefer an API key, for example on a server? Create one in the Cotlet console and use:

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

How to connect Habitica to Codex

Create an API key in the Cotlet console, put it in the COTLET_API_KEY environment variable and add this to ~/.codex/config.toml:

[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

How to connect Habitica to Cursor

Create an API key in the Cotlet console, put it in the COTLET_API_KEY environment variable and add this to ~/.cursor/mcp.json:

{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
}

How to connect Habitica to Grok

Grok takes custom MCP servers on grok.com, per xAI's connectors documentation (checked 8 November 2026).

  1. Open grok.com/connectors and click New Connector.
  2. Pick Custom and paste the server URL https://cotlet.dev/mcp/v1/connect.
  3. Sign in to Cotlet when Grok asks, then click Allow access.
  4. Ask Grok: "Are you signed in to Cotlet through MCP?"

On Grok Business, an admin adds the connector first in the xAI console, under Grok Business, Connectors. The Grok chat inside X has no custom connector menu.

How to connect Habitica to Hermes Agent

Add Cotlet to ~/.hermes/config.yaml in the format of the Hermes MCP config reference:

mcp_servers:
cotlet:
url: "https://cotlet.dev/mcp/v1"
headers:
Authorization: "Bearer ${COTLET_API_KEY}"
trust: untrusted

Put COTLET_API_KEY in ~/.hermes/.env and check it with hermes mcp test cotlet. With trust: untrusted, Hermes runs reads at once and asks before every write. More on Hermes in our post on the Hermes Agent browser.

How to connect Habitica to n8n

Use the MCP Client node, or the MCP Client Tool inside an AI Agent node:

  • Server Transport: HTTP Streamable
  • MCP Endpoint URL: https://cotlet.dev/mcp/v1
  • Authentication: Bearer Auth, with your Cotlet API key as the token
  • Tools: let the AI Agent node use Cotlet's browser tools; it reads Cotlet's Habitica guide first and works in your signed-in Habitica account

Use it for work that should run on its own, such as an evening list of the dailies you have not ticked yet.

Any other MCP client

Point the client at https://cotlet.dev/mcp/v1 over Streamable HTTP, with the header Authorization: Bearer <your Cotlet API key>. A client that supports OAuth sign-in can use https://cotlet.dev/mcp/v1/connect instead and needs no key. The full reference is in the MCP docs.

Step 3: ask for a first job

Pick one job you did by hand this week, ask for it, and check the result in your Habitica tasks. For example: "Read my notes from today, turn each task into a Habitica to-do with a checklist, and ask me before you delete or change anything else." Your agent asks you before it deletes a task, buys from a shop or posts in your party chat.

No official MCP

Does Habitica have an MCP server? No official Habitica MCP server.

Habitica: no official MCP server found on habitica.com; the MCP servers found for Habitica are community projects (checked 20 Nov 2026).

  • Habitica has a public API, webhooks and a Make app for scripts and scenarios of your own, and a Data Export in Settings.
  • Cotlet works in your signed-in Habitica account, on the same tasks, party and challenges you use every day.
  • The full picture with sources: Does Habitica have an API or MCP server?

0/3

Official MCP server

None

Full API & MCP report

Checked 20 Nov 2026. Sources: MCP Registry search · Habitica source: Settings text · Habitica GitHub wiki: API Usage Guidelines

Your login, your screens

Which Habitica screens can your agent work in?

Your agent works on the screens your Habitica login opens. An owner sees everything. A team member sees what their permissions allow.

Screen

Habitica screens your agent can work in

Examples of what you can ask for

  • Tasks

    • Habits
    • dailies and to-dos
    • a new to-do with a checklist
  • Party

    • Your party and its quest
    • a chat message you approve
  • Challenges

    • The challenges you joined and their tasks
  • Inventory

    • Your equipment
    • pets and mounts
  • Shops

    • What your gold buys
    • a purchase you approve

What Habitica offers on its own: Does Habitica have an API or MCP server?

Encrypted, revocable

Who can see my Habitica session, and how do I stop it?

Security overview

  • What Cotlet keeps

Your signed-in Habitica browser profile, encrypted with AES-256-GCM, in Finland. No password.

  • What your agent sees

The same pages your Habitica login shows. Nothing more.

  • When Habitica signs you out

You get an email with a link and sign in again yourself.

  • How to stop it

Disable Habitica for agents, reset the browser or delete the key, in the Cotlet console.

A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

Asks first

Your agent asks before it changes anything Nothing is deleted, bought or posted until you say yes.

  1. 1

Finds the tasks

By type, tag or due day. 2. 2

Reads your list

What repeats, what is done, what is old. 3. 3

Asks for your OK

Before it deletes a task, buys from a shop or posts in your party chat. 4. 4

Reports back

What changed, and what waits for you.

Your agent asks you before it deletes a task, buys from a shop or posts in your party chat. Tasks, checklists and tags are only seen by you. Check each change in your Habitica tasks.

Which Habitica actions can be undone

ActionUndo
Delete a taskNot from Cotlet. Check Habitica's own rules before you allow it
Buy from a shopNot from Cotlet. Check Habitica's own rules before you allow it
Post in your party chatNot from Cotlet. Check Habitica's own rules before you allow it
Add, tag or tick a taskCheck it in Habitica after the change

Pay as you go

What does Cotlet cost?

Full pricing

  • From $29
    one-time pack of 5,000 credits, valid for 365 days, no subscription
  • 50 credits
    a day of Cloud Browser for agents
  • 5 credits
    a minute of agent work
  • 7 days
    free trial with 2,000 credits, no card

Cotlet credit packs: price and credits

CreditsPrice, one timePer 1,000 credits
5,000$29$5.80
15,000$79$5.27
32,000$149$4.66
60,000$249$4.15

Cotlet is best for Habitica players who want ChatGPT or Claude to add, sort and tidy their tasks in plain words.

  • No API token or script needed

EU company, since 2019

Who runs Cotlet A company you can look up.

About us

Cotlet is run by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), working since 2019. The founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about Habitica on Cotlet go to contact@cotlet.dev.

Company

Take Group sp. z o.o.

Registered

Poland, EU

VAT

PL6342984273

Working since

2019

Founders

Bart Krawczyk and Jake Slugocki

Habitica and AI agents: questions

Is this an official Habitica integration?

No. Cotlet is independent and not affiliated with Habitica. Your agent works through your own signed-in Habitica account, the way you would by hand.

Should I use the Habitica API instead?

If you write code, Habitica's public API and webhooks cover scripts of your own. Cotlet is for asking your AI assistant in plain words, on the tasks and party you already use.

Is this one of the community MCP projects?

No. Cotlet is a separate service: a cloud browser signed in to your own Habitica account, not a server built on the Habitica API.

What can the agent not do in Habitica?

Your agent cannot do more than your own Habitica login. Your subscription, gems and account settings are jobs to keep in your own hands.

Can I use Habitica with n8n?

Yes. n8n connects to Cotlet with its MCP Client Tool and a Cotlet API key, and runs the same jobs on a schedule.

More planning apps on Cotlet

  • Productivity & teams

Amazing Marvin

Inbox, day plans, projects and timers in Amazing Marvin, run by your agent.

  • Local services & SaaS

Sunsama

Tasks, timeboxing, backlog and objectives in Sunsama, worked by your agent.

  • Productivity & teams

AppFlowy

Pages, databases, trash and sharing in your AppFlowy workspace.

Let your agent keep your Habitica tasks in order

Sign in once, connect ChatGPT or Claude, and hand over the first job today.

Try it free now

No card. Takes about 5 minutes.


Give your AI agents your signed-in browser.

Product: Integrations · MCP servers · APIs · API & MCP status · How it works · Pricing · Security · Custom API

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.