@togetherdone/mcp-server
A Model Context Protocol (MCP) server that lets AI assistants manage your TogetherDone todo lists.
Prerequisites
Get an API key at togetherdone.app/settings/api-keys (requires Pro subscription).
Install
Claude Code
claude mcp add togetherdone -e TOGETHERDONE_API_KEY=td_live_your_key -- npx -y @togetherdone/mcp-server
Claude Desktop
Add to your config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"togetherdone": {
"command": "npx",
"args": ["-y", "@togetherdone/mcp-server"],
"env": {
"TOGETHERDONE_API_KEY": "td_live_your_key_here"
}
}
}
}
Cursor
Add to .cursor/mcp.json in your project:
{
"mcpServers": {
"togetherdone": {
"command": "npx",
"args": ["-y", "@togetherdone/mcp-server"],
"env": {
"TOGETHERDONE_API_KEY": "td_live_your_key_here"
}
}
}
}
Available Tools
| Tool | Description |
|---|---|
list_lists | Get all accessible todo lists |
get_list | Get details of a specific list |
create_list | Create a new todo list |
update_list | Update list title, color, description, etc. |
archive_list | Archive (soft-delete) a list |
list_items | Get items in a list (filterable) |
create_item | Add an item with priority, due date, notes |
update_item | Update item content, status, priority |
complete_item | Mark an item as completed |
archive_item | Archive an item |
list_sections | Get sections in a list |
create_section | Create a section for organizing items |
search | Keyword search across lists and items |
get_profile | Get the authenticated user's profile |
Environment Variables
| Variable | Required | Description |
|---|---|---|
TOGETHERDONE_API_KEY | Yes | Your API key (td_live_xxxxx) |
Example Usage
Once configured, you can ask your AI assistant things like:
- "What's on my todo lists?"
- "Add 'Buy milk' to my Shopping list"
- "Mark the 'Send invoice' item as done"
- "Create a new list called 'Vacation Packing' with the Travel category"
- "Search for anything related to 'meeting'"
Development
npm install
npm run build
npm run start
License
MIT