mcp-intervals 1.0.0 → 1.0.2
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 +124 -0
- package/dist/index.js +0 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
# mcp-intervals
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/mcp-intervals)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
|
|
6
|
+
MCP server for [Intervals](https://www.myintervals.com/) task management. Lets Claude read and update tasks, add notes, and browse projects and milestones directly from your Intervals account.
|
|
7
|
+
|
|
8
|
+
## Setup
|
|
9
|
+
|
|
10
|
+
### 1. Get your Intervals API token
|
|
11
|
+
|
|
12
|
+
1. Log in to your Intervals account
|
|
13
|
+
2. Go to **Options** (bottom-left) > **My Account** > **API Access**
|
|
14
|
+
3. Copy your **API token**
|
|
15
|
+
|
|
16
|
+
### 2. Install in Claude Code
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
# Available in all your projects (recommended)
|
|
20
|
+
claude mcp add intervals --scope user -e INTERVALS_API_TOKEN=YOUR_TOKEN -- npx -y mcp-intervals
|
|
21
|
+
|
|
22
|
+
# Only in the current project, shared with team via .mcp.json (committed to git)
|
|
23
|
+
claude mcp add intervals --scope project -e INTERVALS_API_TOKEN=YOUR_TOKEN -- npx -y mcp-intervals
|
|
24
|
+
|
|
25
|
+
# Only for you in the current project (default)
|
|
26
|
+
claude mcp add intervals -e INTERVALS_API_TOKEN=YOUR_TOKEN -- npx -y mcp-intervals
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Replace `YOUR_TOKEN` with your actual API token.
|
|
30
|
+
|
|
31
|
+
### 3. Install in Claude Desktop
|
|
32
|
+
|
|
33
|
+
Add this to your config file:
|
|
34
|
+
|
|
35
|
+
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
36
|
+
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
37
|
+
|
|
38
|
+
```json
|
|
39
|
+
{
|
|
40
|
+
"mcpServers": {
|
|
41
|
+
"intervals": {
|
|
42
|
+
"command": "npx",
|
|
43
|
+
"args": ["-y", "mcp-intervals"],
|
|
44
|
+
"env": {
|
|
45
|
+
"INTERVALS_API_TOKEN": "YOUR_TOKEN"
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
<details>
|
|
53
|
+
<summary><strong>Cursor</strong></summary>
|
|
54
|
+
|
|
55
|
+
Add to `.cursor/mcp.json` in your project or `~/.cursor/mcp.json` globally:
|
|
56
|
+
|
|
57
|
+
```json
|
|
58
|
+
{
|
|
59
|
+
"mcpServers": {
|
|
60
|
+
"intervals": {
|
|
61
|
+
"command": "npx",
|
|
62
|
+
"args": ["-y", "mcp-intervals"],
|
|
63
|
+
"env": {
|
|
64
|
+
"INTERVALS_API_TOKEN": "YOUR_TOKEN"
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
</details>
|
|
72
|
+
|
|
73
|
+
<details>
|
|
74
|
+
<summary><strong>Windsurf</strong></summary>
|
|
75
|
+
|
|
76
|
+
Add to `~/.codeium/windsurf/mcp_config.json`:
|
|
77
|
+
|
|
78
|
+
```json
|
|
79
|
+
{
|
|
80
|
+
"mcpServers": {
|
|
81
|
+
"intervals": {
|
|
82
|
+
"command": "npx",
|
|
83
|
+
"args": ["-y", "mcp-intervals"],
|
|
84
|
+
"env": {
|
|
85
|
+
"INTERVALS_API_TOKEN": "YOUR_TOKEN"
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
</details>
|
|
93
|
+
|
|
94
|
+
## Available Tools
|
|
95
|
+
|
|
96
|
+
| Tool | Description |
|
|
97
|
+
| ---------------- | ----------------------------------------------------------------- |
|
|
98
|
+
| `get_task` | Get task details by local ID or Intervals URL |
|
|
99
|
+
| `update_task` | Update task status, assignee, priority, title, due date, or owner |
|
|
100
|
+
| `add_task_note` | Add a comment/note to a task (supports HTML) |
|
|
101
|
+
| `get_task_notes` | Retrieve all comments/notes on a task |
|
|
102
|
+
| `get_project` | Get project details (name, client, dates, budget) |
|
|
103
|
+
| `get_milestone` | Get milestone details (title, due date, progress) |
|
|
104
|
+
|
|
105
|
+
## Resources
|
|
106
|
+
|
|
107
|
+
| Resource | URI | Description |
|
|
108
|
+
| --------------- | ------------------------ | --------------------------------------------------- |
|
|
109
|
+
| Task Statuses | `intervals://statuses` | List of all status IDs for use with `update_task` |
|
|
110
|
+
| Task Priorities | `intervals://priorities` | List of all priority IDs for use with `update_task` |
|
|
111
|
+
|
|
112
|
+
## Example Usage
|
|
113
|
+
|
|
114
|
+
Once installed, you can ask Claude things like:
|
|
115
|
+
|
|
116
|
+
- "Get the details of task 1234"
|
|
117
|
+
- "Update task 1234 status to closed"
|
|
118
|
+
- "Add a note to task 1234 saying the fix has been deployed"
|
|
119
|
+
- "Show me all notes on task 1234"
|
|
120
|
+
- "What are the details of project 5?"
|
|
121
|
+
|
|
122
|
+
## License
|
|
123
|
+
|
|
124
|
+
MIT
|
package/dist/index.js
CHANGED
|
File without changes
|