glintlint-mcp
v1.7.0
Published
MCP Server for Glintlint - manage your tasks and diary with AI assistants
Downloads
773
Maintainers
Readme
Glintlint MCP Server
MCP (Model Context Protocol) server for Glintlint — manage your tasks and diary with AI assistants like Claude Desktop, Cursor, and more.
Features
- 13 tools for task & diary management
- Task tools: list, create, update, complete, delete tasks + groups + stats + today summary
- Diary tools: list, create, update, delete diary entries + get today's diary
- Works with Claude Desktop, Cursor, and any MCP-compatible AI tool
Prerequisites
- Node.js 20+
- A Glintlint account with an API key (get one from Settings > API Keys)
Installation
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"glintlint": {
"command": "npx",
"args": ["-y", "glintlint-mcp"],
"env": {
"GLINTLINT_API_KEY": "glint_your_api_key_here"
}
}
}
}Cursor
Add to your MCP settings:
{
"mcpServers": {
"glintlint": {
"command": "npx",
"args": ["-y", "glintlint-mcp"],
"env": {
"GLINTLINT_API_KEY": "glint_your_api_key_here"
}
}
}
}Available Tools
Task Tools
| Tool | Description |
|------|-------------|
| list_tasks | List tasks with filters (date, status, priority, group, time block) |
| create_task | Create a new task with title, date, priority, time block, etc. |
| update_task | Update any field of an existing task |
| complete_task | Mark a task as completed |
| delete_task | Permanently delete a task |
| get_today_summary | Get today's tasks grouped by time block + statistics |
| list_groups | List all task groups |
| get_stats | Get completion rate, priority distribution, overdue count |
Diary Tools
| Tool | Description |
|------|-------------|
| list_diary | List diary entries with filters (date range, mood, tag, pinned) |
| create_diary | Create a new diary entry (one per day, auto-sets created_by: "mcp") |
| update_diary | Update any field of an existing diary entry |
| delete_diary | Permanently delete a diary entry |
| get_today_diary | Get today's diary entry (useful for checking before appending) |
Usage Examples
Once configured, you can ask your AI assistant:
Tasks:
- "What are my tasks for today?"
- "Create a task: review PR tomorrow morning, high priority"
- "Mark the task about writing docs as complete"
- "Show me my task statistics for this week"
Diary:
- "What did I write in my diary today?"
- "Create a diary entry for today: had a productive day, finished the API refactor"
- "Show me my diary entries from last week"
- "Add a summary to today's diary entry"
Environment Variables
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| GLINTLINT_API_KEY | Yes | — | Your API key (starts with glint_) |
| GLINTLINT_BASE_URL | No | https://www.glintlint.com | API base URL |
API Key Scopes
Your API key needs the following scopes for full functionality:
tasks:read— list and view taskstasks:write— create, update, delete tasksgroups:read— list groupsstats:read— view statisticsdiary:read— list and view diary entriesdiary:write— create, update, delete diary entries
License
MIT
