MCP Server.

Connect to AI assistants via Model Context Protocol.

The Clear Tangle MCP Server lets Claude, ChatGPT, and supported local clients work with your Clear Tangle account. Hosted connections use secure OAuth, keep access tied to the signed-in user, and send sensitive actions back to Clear Tangle for approval.

WHAT IS MCP?The Model Context Protocol (MCP) is a standard that allows AI assistants to use external tools and data sources. Clear Tangle supports hosted assistant connections as well as a local MCP package for compatible clients.

Supported platforms

ClaudeBETA

Hosted OAuth

ChatGPTBETA

Hosted OAuth

CursorLocal MCP package

KiroLocal MCP package

Connect Claude or ChatGPT

Hosted connections require no local installation. Clear Tangle shows the connection values and platform-specific instructions inside your account.

1Open Clear Tangle Settings → Integrations → AI Assistants.

2Choose Claude or ChatGPT and open its setup guide.

3Copy the MCP server URL and the platform’s public OAuth Client ID.

4Add Clear Tangle in the assistant using the exact settings shown in the guide. Do not enter a client secret.

5Sign in to Clear Tangle, review the identity and tool-access disclosures, then allow tool access.

6Verify the connection by asking the assistant to search your Clear Tangle account.

Open AI Assistant Connections →

HOSTED SAFEGUARDS

Read requests can use your current account data after connection. Actions that change data, send externally, publish, archive, automate work, or use AI credits create a pending approval in Clear Tangle. Delete tools are never available through hosted assistant connections.

If a connection card says Admin setup required, your Clear Tangle administrator must finish the platform’s OAuth configuration before you can connect.

Local MCP package

For Cursor, Kiro, Claude Desktop, and other compatible local clients, run the standalone package with npx:

Run with npx · bash

$ npx clear-tangle-mcp

Global installation · bash

$ npm install -g clear-tangle-mcp

Local client configuration

Claude Desktop

Config file locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.jsonLinux: ~/.config/claude/claude_desktop_config.json

claude_desktop_config.json

{

"mcpServers": {

"clear-tangle": {

"command": "npx",

"args": ["-y", "clear-tangle-mcp"],

"env": {

"BACKEND_URL": "https://app.cleartangle.com/api",

"LOGIN_URL": "https://app.cleartangle.com/login"

}

Cursor

Config: ~/Library/Application Support/Cursor/User/globalStorage/cursor.mcp/settings.json

Same JSON format as Claude Desktop.

Kiro

Config: ~/.kiro/mcp-servers.json

mcp-servers.json

{

"servers": {

"clear-tangle": {

"command": "npx",

"args": ["-y", "clear-tangle-mcp"],

"environment": {

"BACKEND_URL": "https://app.cleartangle.com/api",

"LOGIN_URL": "https://app.cleartangle.com/login"

}

Local package authentication

HOSTED USES OAUTH

The four options below apply to the standalone local package. Claude and ChatGPT hosted connections use the OAuth flow shown in Clear Tangle’s AI Assistants tab.

01 · RECOMMENDEDAPI key

Best for automation. Create an API key in Settings › API Keys and add it to your config:

"env": {

"CLEARTANGLE_API_KEY": "ctak_xxxx_xxxxxxxx…",

"BACKEND_URL": "https://app.cleartangle.com/api"

}

API keys don’t expire and persist across restarts. Learn more about API keys

02Browser auth

Say “authenticate with Clear Tangle” to your AI assistant. A browser window opens, you log in, and the token is captured automatically.

03Credential auth

Set environment variables for auto-login:

"env": {

"CLEARTANGLE_USERNAME": "your@email.com",

"CLEARTANGLE_PASSWORD": "your-password"

}

04Manual token / key

Say “set my Clear Tangle API key to [key]” or “set my Clear Tangle token to [token]” at runtime.

TOKEN STORAGE

Credentials are stored locally at ~/.clear-tangle-mcp/token.json. JWT tokens expire after 24 hours; API keys persist indefinitely until revoked.

Local package tools (21)

Claude and ChatGPT hosted connections expose Clear Tangle’s current non-delete tool suite. Read tools run against your account; sensitive actions wait for approval in Clear Tangle.

Authentication7

authenticateBrowser-based OAuth login

login_with_credentialsEmail/password login

set_api_keySet API key (recommended)

set_tokenManually set JWT token

check_authCheck auth status

test_connectionDiagnose connectivity

logoutClear credentials

Tasks7

list_tasksList with filters

get_taskGet task details

create_taskCreate new task

update_taskUpdate task

complete_taskMark complete

delete_taskDelete task (local package only)

get_tasks_dashboardDashboard view

Thoughts5

list_thoughtsList captures

get_thoughtGet capture details

capture_thoughtCreate capture

update_thoughtUpdate capture

delete_thoughtDelete capture (local package only)

Plans2

get_planGet current plan

generate_planGenerate new plan

Example conversations

›Search my Clear Tangle for the latest project decision

›Create a task called "Review PR #123" with high priority

›Show me my tasks for today

›Capture this thought: "Remember to update the documentation"

›Generate a priority plan for the week

›What tasks are overdue?

›Mark task xyz-123 as completed

Security best practices

Use the hosted OAuth connection for Claude and ChatGPTReview pending changes and external actions before approving them in Clear TangleNever enter or share a client secret for the hosted public OAuth clientsFor the local package, store credentials in a secure environment manager rather than a config fileSet local token-file permissions to chmod 600 ~/.clear-tangle-mcp/token.jsonKeep local MCP configuration files out of version control

Local package environment variables

VARIABLEDEFAULTDESCRIPTION

CLEARTANGLE_API_KEY(none)API key (recommended)

BACKEND_URLhttps://app.cleartangle.com/apiAPI base URL

LOGIN_URLhttps://app.cleartangle.com/loginLogin page URL

CLEARTANGLE_USERNAME(none)Auto-login email

CLEARTANGLE_PASSWORD(none)Auto-login password

MCP Server.

Connect to AI assistants via Model Context Protocol.

Supported platforms

ClaudeBETA

Hosted OAuth

ChatGPTBETA

Hosted OAuth

Cursor

Local MCP package

Kiro

Local MCP package

Connect Claude or ChatGPT

Hosted connections require no local installation. Clear Tangle shows the connection values and platform-specific instructions inside your account.

1Open Clear Tangle Settings → Integrations → AI Assistants.

2Choose Claude or ChatGPT and open its setup guide.

3Copy the MCP server URL and the platform’s public OAuth Client ID.

4Add Clear Tangle in the assistant using the exact settings shown in the guide. Do not enter a client secret.

5Sign in to Clear Tangle, review the identity and tool-access disclosures, then allow tool access.

6Verify the connection by asking the assistant to search your Clear Tangle account.

Open AI Assistant Connections →

HOSTED SAFEGUARDS

If a connection card says Admin setup required, your Clear Tangle administrator must finish the platform’s OAuth configuration before you can connect.

Local MCP package

For Cursor, Kiro, Claude Desktop, and other compatible local clients, run the standalone package with npx:

Run with npx · bash

$ npx clear-tangle-mcp

Global installation · bash

$ npm install -g clear-tangle-mcp

Local client configuration

Claude Desktop

Config file locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Linux: ~/.config/claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "clear-tangle": {
      "command": "npx",
      "args": ["-y", "clear-tangle-mcp"],
      "env": {
        "BACKEND_URL": "https://app.cleartangle.com/api",
        "LOGIN_URL": "https://app.cleartangle.com/login"
      }
    }
  }
}

Cursor

Config: ~/Library/Application Support/Cursor/User/globalStorage/cursor.mcp/settings.json

Same JSON format as Claude Desktop.

Kiro

Config: ~/.kiro/mcp-servers.json

mcp-servers.json

{
  "servers": {
    "clear-tangle": {
      "command": "npx",
      "args": ["-y", "clear-tangle-mcp"],
      "environment": {
        "BACKEND_URL": "https://app.cleartangle.com/api",
        "LOGIN_URL": "https://app.cleartangle.com/login"
      }
    }
  }
}

Local package authentication

HOSTED USES OAUTH

The four options below apply to the standalone local package. Claude and ChatGPT hosted connections use the OAuth flow shown in Clear Tangle’s AI Assistants tab.

01 · RECOMMENDEDAPI key

Best for automation. Create an API key in Settings › API Keys and add it to your config:

"env": {
  "CLEARTANGLE_API_KEY": "ctak_xxxx_xxxxxxxx…",
  "BACKEND_URL": "https://app.cleartangle.com/api"
}

API keys don’t expire and persist across restarts. Learn more about API keys

02Browser auth

Say “authenticate with Clear Tangle” to your AI assistant. A browser window opens, you log in, and the token is captured automatically.

03Credential auth

Set environment variables for auto-login:

"env": {
  "CLEARTANGLE_USERNAME": "your@email.com",
  "CLEARTANGLE_PASSWORD": "your-password"
}

04Manual token / key

Say “set my Clear Tangle API key to [key]” or “set my Clear Tangle token to [token]” at runtime.

TOKEN STORAGE

Credentials are stored locally at ~/.clear-tangle-mcp/token.json. JWT tokens expire after 24 hours; API keys persist indefinitely until revoked.

Local package tools (21)

Claude and ChatGPT hosted connections expose Clear Tangle’s current non-delete tool suite. Read tools run against your account; sensitive actions wait for approval in Clear Tangle.

Authentication7

authenticateBrowser-based OAuth login

login_with_credentialsEmail/password login

set_api_keySet API key (recommended)

set_tokenManually set JWT token

check_authCheck auth status

test_connectionDiagnose connectivity

logoutClear credentials

Tasks7

list_tasksList with filters

get_taskGet task details

create_taskCreate new task

update_taskUpdate task

complete_taskMark complete

delete_taskDelete task (local package only)

get_tasks_dashboardDashboard view

Thoughts5

list_thoughtsList captures

get_thoughtGet capture details

capture_thoughtCreate capture

update_thoughtUpdate capture

delete_thoughtDelete capture (local package only)

Plans2

get_planGet current plan

generate_planGenerate new plan

Example conversations

›Search my Clear Tangle for the latest project decision

›Create a task called "Review PR #123" with high priority

›Show me my tasks for today

›Capture this thought: "Remember to update the documentation"

›Generate a priority plan for the week

›What tasks are overdue?

›Mark task xyz-123 as completed

Security best practices

Use the hosted OAuth connection for Claude and ChatGPT

Review pending changes and external actions before approving them in Clear Tangle

Never enter or share a client secret for the hosted public OAuth clients

For the local package, store credentials in a secure environment manager rather than a config file

Set local token-file permissions to chmod 600 ~/.clear-tangle-mcp/token.json

Keep local MCP configuration files out of version control

Local package environment variables

VARIABLEDEFAULTDESCRIPTION

CLEARTANGLE_API_KEY(none)API key (recommended)

BACKEND_URLhttps://app.cleartangle.com/apiAPI base URL

LOGIN_URLhttps://app.cleartangle.com/loginLogin page URL

CLEARTANGLE_USERNAME(none)Auto-login email

CLEARTANGLE_PASSWORD(none)Auto-login password

MCP Server.

Supported platforms

Connect Claude or ChatGPT

Local MCP package

Local client configuration

Claude Desktop

Cursor

Kiro

Local package authentication

Local package tools (21)

Example conversations

Security best practices

Local package environment variables

Related documentation

MCP Server.

Supported platforms

Connect Claude or ChatGPT

Local MCP package

Local client configuration

Claude Desktop

Cursor

Kiro

Local package authentication

Local package tools (21)

Example conversations

Security best practices

Local package environment variables

Related documentation