https://github.com/studiometa/productive-tools
CLI tool for interacting with the Productive.io API
https://github.com/studiometa/productive-tools
Last synced: 4 months ago
JSON representation
CLI tool for interacting with the Productive.io API
- Host: GitHub
- URL: https://github.com/studiometa/productive-tools
- Owner: studiometa
- License: mit
- Created: 2026-01-16T09:07:29.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-21T08:22:13.000Z (4 months ago)
- Last Synced: 2026-02-21T16:08:47.627Z (4 months ago)
- Language: TypeScript
- Homepage:
- Size: 1.42 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Productive.io Tools
[](https://github.com/studiometa/productive-tools/actions/workflows/ci.yml)
[](https://opensource.org/licenses/MIT)
Monorepo for [Productive.io](https://productive.io) integration tools — CLI and MCP server for AI agents and humans.
## Packages
| Package | Description |
| ------------------------------------------------ | ------------------------------------------------------------------------- |
| [`@studiometa/productive-cli`](./packages/cli) | CLI for Productive.io — projects, time tracking, tasks, reports, and more |
| [`@studiometa/productive-mcp`](./packages/mcp) | MCP server for Claude Desktop and other MCP clients |
| [`@studiometa/productive-core`](./packages/core) | Shared business logic — executor functions with injectable dependencies |
| [`@studiometa/productive-api`](./packages/api) | API client, types, and response formatters |
## Quick Start
### CLI
```bash
npm install -g @studiometa/productive-cli
productive config set apiToken YOUR_TOKEN
productive config set organizationId YOUR_ORG_ID
productive config set userId YOUR_USER_ID
productive projects list
productive time list --from 2025-01-01
productive reports time --from 2025-01-01
```
### MCP Server (Claude Desktop)
```bash
npm install -g @studiometa/productive-mcp
```
Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"productive": {
"command": "productive-mcp",
"env": {
"PRODUCTIVE_ORG_ID": "your-org-id",
"PRODUCTIVE_API_TOKEN": "your-auth-token",
"PRODUCTIVE_USER_ID": "your-user-id"
}
}
}
}
```
## Requirements
- **Node.js 24+**
- **Productive.io account** with API access
## Getting Productive.io Credentials
1. Log into [Productive.io](https://productive.io)
2. Go to **Settings → Integrations → API**
3. Generate an API token
4. Note your Organization ID (visible in API settings or URL)
5. Note your User ID (click your profile, visible in URL)
## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md).
## License
MIT © [Studio Meta](https://www.studiometa.fr)