MCP integration

Connect Claude to your Kokoroe account

Let Claude (or any MCP-compatible client) read and act on your tasks and journal entries, scoped to one organization at a time. Takes about a minute to set up.

What is MCP?

Model Context Protocol is an open standard for letting AI assistants safely access tools and data from external services. Instead of copy-pasting context into a chat window, you grant the AI scoped, revocable access to specific functions — like "list my tasks" or "create a journal entry" — and it can call them on your behalf when it makes sense in the conversation.

You stay in control: the AI can only do what you explicitly authorize, scoped to a single organization, and you can revoke access at any time from your Settings page.

Server URL

https://kokoroe.ai/api/mcp

You'll paste this into Claude Desktop in the next step.

Add to Claude Desktop (3 steps)

Add the connector

In Claude Desktop, open Settings → Connectors → Add custom connector (the exact menu name varies by Claude Desktop version — look for "MCP" or "Custom Connector").

Name it anything you like ("Kokoroe", "My Tasks", etc.) and paste https://kokoroe.ai/api/mcp as the URL. Click Save.

Claude Desktop will detect that the server needs OAuth and open a browser tab to start the sign-in flow.

Sign in (if needed) and authorize

You'll be sent to Kokoroe to sign in. If you're already signed in, you'll skip straight to the consent screen.

On the consent page you'll see three things:

The app requesting access (Claude Desktop, with its name and website).
Authorize for organization — if you're a member of multiple orgs, a dropdown lets you pick which one this app will see. The connection is locked to that org; even if you switch your in-app active org later, Claude will keep seeing the org you picked here.
Requested permissions — each bullet is one capability ("Read your tasks", "Create and edit tasks", "Search your content"). These map 1:1 to the tools below.

Click Authorize. The browser tab redirects back to Claude Desktop and the connection is live.

Start using it

Just talk to Claude normally. When your request maps to one of the tools below, Claude picks the right one automatically and asks you to confirm before any write (creating, editing, completing).

Try the example prompts in the next section.

What you can ask Claude

Once connected, any of these prompts (or anything that means the same thing in your own words) will route through the appropriate tool.

list_tasks

See your tasks at a glance, optionally filtered by status.

"List my open tasks"
"Show me everything that’s blocked"
"What’s in progress right now?"

get_task

Read the full details of a specific task by its display ID.

"Show me STAK-42"
"What’s the full description of COM-17?"

create_task

Create a new task. Claude will ask for confirmation before writing.

"Create a task titled "Review Q3 budget""
"Add a bug for the broken dashboard chart"

update_task

Edit an existing task — title, description, status, priority, severity, assignee.

"Change STAK-42’s priority to high"
"Update the description of COM-17 to add the latest meeting notes"

assign_task_to_me

Assign a task to yourself. Convenience shortcut.

"Assign STAK-42 to me"
"Take ownership of COM-17"

start_task

Move a task to in-progress. Convenience shortcut.

"Start STAK-42"
"Mark COM-17 as in progress"

complete_task

Mark a task done. Convenience shortcut.

"Complete STAK-42"
"Mark COM-17 as done"

search

Semantic search across your published journal entries and tasks.

"Search for anything about onboarding"
"Find tasks related to authentication"

list_entries

Browse your published journal entries (private entries are never shown).

"Show me my latest journal entries"
"What did I publish last week?"

get_entry

Read a specific journal entry by ID (only if not marked private).

"Read the full journal entry about the leadership offsite"

create_entry

Create a new journal entry. Claude will ask for confirmation.

"Create a journal entry titled "Weekly retrospective" with the following content..."

update_entry

Edit an existing journal entry (title, content, status).

"Update my entry on Q3 planning to add the new action items"

Revoking access

Go to Settings → Authorized apps. You'll see every app connected to your account, which org it's bound to, what scopes it has, and when you authorized it. Click Revoke on any row to immediately cut off its access — the next request that app makes will be rejected, and the row disappears from the list.

Revoking is instant and permanent. To reconnect, the app has to walk through the full consent flow again.

Troubleshooting

Claude says it can't connect

Double-check the URL is exactly https://kokoroe.ai/api/mcp (https, not http). If your network blocks third-party OAuth flows, you may need to ask your IT team to whitelist kokoroe.ai.

"Maximum of 2 connected apps reached"

Each user account can have up to 2 OAuth apps connected at a time. Revoke an existing one in Settings → Authorized apps before connecting a new app.

Claude doesn't see a task I just created

Tasks created in the org you authorized show up immediately. If you created it in a different org, switch which org Claude is connected to: revoke the current connection and re-authorize with the right org selected on the consent screen.

The connection works but stops after a while

Access tokens expire after about an hour; Claude Desktop refreshes them automatically. If you see a re-authorization prompt, just walk through the consent flow again — it takes seconds and remembers your previous scope grants.