AI-native

Connect your AI to Tweloc

Use the Model Context Protocol (MCP) to let Claude, ChatGPT, or any AI assistant manage your tasks directly. No code required.

Available tools

list_tasks

List and filter tasks by status, priority, or date

add_task

Create new tasks with title, deadline, and priority

complete_task

Mark tasks as completed

update_task

Change title, deadline, priority, or status

delete_task

Soft-delete tasks (move to trash)

weekly_summary

Get a summary of this week — completed, pending, overdue

Setup in 3 steps

Generate an API key

Go to Settings and create a personal API key. This key lets your AI access your tasks securely.

Settings → API Keys → Generate

Your key starts with twl_

Add to your AI config

Paste this into your Claude Desktop config. Replace the key with yours.

{
  "mcpServers": {
    "tweloc": {
      "url": "https://tweloc.com/api/mcp",
      "headers": {
        "Authorization": "Bearer twl_your_api_key_here"
      }
    }
  }
}

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

Start talking to your tasks

Restart Claude Desktop. You can now say things like:

"What tasks do I have this week?"

"Add a task: Review PR #42, due Friday, high priority"

"Mark the PR review task as done"

"Give me my weekly summary"

Works with Claude Code too

Add the MCP to Claude Code with one command:

claude mcp add tweloc --url https://tweloc.com/api/mcp -H "Authorization: Bearer twl_your_key"

REST API

The same API key works with our REST endpoints. Build your own integrations, scripts, or automations.

GET/api/v1/tasksList tasks

POST/api/v1/tasksCreate a task

PATCH/api/v1/tasks/:idUpdate a task

DELETE/api/v1/tasks/:idDelete a task

GET/api/v1/tasks/summaryWeekly summary

Authenticate with Authorization: Bearer twl_your_key

Ready to connect?

Go to Settings