@doist/todoist-ai 4.6.1 → 4.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +61 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Todoist AI SDK
|
|
1
|
+
# Todoist AI and MCP SDK
|
|
2
2
|
|
|
3
3
|
Library for connecting AI agents to Todoist. Includes tools that can be integrated into LLMs,
|
|
4
4
|
enabling them to access and modify a Todoist account on the user's behalf.
|
|
@@ -34,12 +34,72 @@ const result = streamText({
|
|
|
34
34
|
|
|
35
35
|
## Using as an MCP server
|
|
36
36
|
|
|
37
|
+
### Quick Start
|
|
38
|
+
|
|
37
39
|
You can run the MCP server directly with npx:
|
|
38
40
|
|
|
39
41
|
```bash
|
|
40
42
|
npx @doist/todoist-ai
|
|
41
43
|
```
|
|
42
44
|
|
|
45
|
+
### Setup Guide
|
|
46
|
+
|
|
47
|
+
The Todoist AI MCP server is available as a streamable HTTP service for easy integration with various AI clients:
|
|
48
|
+
|
|
49
|
+
**Primary URL (Streamable HTTP):** `https://ai.todoist.net/mcp`
|
|
50
|
+
|
|
51
|
+
#### Claude Desktop
|
|
52
|
+
|
|
53
|
+
1. Open Settings → Connectors → Add custom connector
|
|
54
|
+
2. Enter `https://ai.todoist.net/mcp` and complete OAuth authentication
|
|
55
|
+
|
|
56
|
+
#### Cursor
|
|
57
|
+
|
|
58
|
+
Create a configuration file:
|
|
59
|
+
- **Global:** `~/.cursor/mcp.json`
|
|
60
|
+
- **Project-specific:** `.cursor/mcp.json`
|
|
61
|
+
|
|
62
|
+
```json
|
|
63
|
+
{
|
|
64
|
+
"mcpServers": {
|
|
65
|
+
"todoist": {
|
|
66
|
+
"command": "npx",
|
|
67
|
+
"args": ["-y", "mcp-remote", "https://ai.todoist.net/mcp"]
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Then enable the server in Cursor settings if prompted.
|
|
74
|
+
|
|
75
|
+
#### Claude Code (CLI)
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
claude mcp add --transport http todoist https://ai.todoist.net/mcp
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
#### Visual Studio Code
|
|
82
|
+
|
|
83
|
+
1. Open Command Palette → MCP: Add Server
|
|
84
|
+
2. Select HTTP transport and use:
|
|
85
|
+
|
|
86
|
+
```json
|
|
87
|
+
{
|
|
88
|
+
"servers": {
|
|
89
|
+
"todoist": {
|
|
90
|
+
"type": "http",
|
|
91
|
+
"url": "https://ai.todoist.net/mcp"
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
#### Other MCP Clients
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
npx -y mcp-remote https://ai.todoist.net/mcp
|
|
101
|
+
```
|
|
102
|
+
|
|
43
103
|
For more details on setting up and using the MCP server, including creating custom servers, see [docs/mcp-server.md](docs/mcp-server.md).
|
|
44
104
|
|
|
45
105
|
## Features
|