English Français العربية

com.pyunto/time-management

السجل الرسمي الذكاء الاصطناعي والوكلاء

Read your Pyunto Time Management schedule and log time from an AI assistant. E2EE project planning.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @pyunto/tm-mcp
Claude Code 
claude mcp add time-management -e 'PYUNTO_TM_API_KEY=<your pyunto_tm_api_key>' -e 'PYUNTO_TM_BASE_URL=https://tm.pyunto.com' -e 'PYUNTO_TM_PASSWORD=<your pyunto_tm_password>' -e 'PYUNTO_TM_PASSWORD_FILE=<your pyunto_tm_password_file>' -- npx -y @pyunto/tm-mcp@0.3.6
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "time-management": {
            "command": "npx",
            "args": [
                "-y",
                "@pyunto/tm-mcp@0.3.6"
            ],
            "env": {
                "PYUNTO_TM_API_KEY": "<your pyunto_tm_api_key>",
                "PYUNTO_TM_BASE_URL": "https://tm.pyunto.com",
                "PYUNTO_TM_PASSWORD": "<your pyunto_tm_password>",
                "PYUNTO_TM_PASSWORD_FILE": "<your pyunto_tm_password_file>"
            }
        }
    }
}

متغيرات البيئة

  • PYUNTO_TM_API_KEY إلزامي سري API key (ptm_...) minted in Settings → Account → API keys. Required to read or write data; listing the tools works without it.
  • PYUNTO_TM_BASE_URL Base URL, for self-hosted instances
  • PYUNTO_TM_PASSWORD سري Account password; unwraps the private key locally so E2EE project and task names decrypt
  • PYUNTO_TM_PASSWORD_FILE سري Path to a file holding the account password, instead of PYUNTO_TM_PASSWORD

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Pyunto Time Management — integrations
  2. Why this part is public
  3. Quick start (MCP)
  4. Quick start (SDK)
  5. Development
  6. Security
  7. Licence

Pyunto Time Management — integrations

Open-source client libraries for Pyunto Time Management, a time-management and project-planning service with end-to-end encryption.

PackageWhat it is
@pyunto/tm-sdkTypeScript client for the public REST API (v1), with client-side E2EE decryption
@pyunto/tm-mcpMCP (Model Context Protocol) server — connects Claude Code, Claude Desktop, Codex CLI, Cursor and other AI clients to an account

The service itself is not open source. This repository contains only the client side: HTTP calls against the documented public API, plus the crypto needed to decrypt your own data locally. There is nothing here that talks to the database, handles billing, or holds a key.

Why this part is public

The MCP server can be given your account password so it can decrypt project and task names. That is a lot to ask of a program you cannot read, so this is the part we publish: you can verify for yourself that the password is used only to unwrap the private key in your own process, and is never transmitted.

See sdk/src/crypto.ts for the primitives and mcp/src/index.ts for how they're used.

Quick start (MCP)

No clone needed — the published package runs straight from npm:

claude mcp add pyunto-tm \
  --env PYUNTO_TM_API_KEY=ptm_your_key \
  -- npx -y @pyunto/tm-mcp

Full setup instructions, including Claude Desktop, Codex CLI and Cursor: https://tm.pyunto.com/docs/mcp.en.md (日本語: https://tm.pyunto.com/docs/mcp.ja.md).

Get an API key from Settings → Account → API keys in the app. Scopes decide what an integration may read or write, and a key can be revoked at any time.

Quick start (SDK)

npm install @pyunto/tm-sdk
import { PyuntoTM } from "@pyunto/tm-sdk";

const tm = new PyuntoTM({ apiKey: process.env.PTM_KEY! });

// Dates, durations and aggregates need no key material at all
const record = await tm.serviceRecord("2026-08-01", "2026-08-31");

// Names and memos are encrypted; unlock decrypts them locally
await tm.unlock(process.env.PTM_PASSWORD!);
const projects = await tm.projects({ decrypt: true });

Development

npm workspaces; Node 18+.

npm install
npm run build     # both packages
npm test          # sdk crypto round-trips + mcp tools against a stub API

mcp depends on @pyunto/tm-sdk by version, so the published package resolves it from the registry while local development links the workspace copy.

Security

Found a problem in this code, or in the service? Please report it privately rather than opening a public issue: support@pyunto.com.

Licence

MIT — see LICENSE.

الأسئلة الشائعة

ما هو com.pyunto/time-management؟

Read your Pyunto Time Management schedule and log time from an AI assistant. E2EE project planning.

كيف أثبّت com.pyunto/time-management؟

يعمل على جهازك. في Claude Code: claude mcp add time-management -e 'PYUNTO_TM_API_KEY=<your pyunto_tm_api_key>' -e 'PYUNTO_TM_BASE_URL=https://tm.pyunto.com' -e 'PYUNTO_TM_PASSWORD=<your pyunto_tm_password>' -e 'PYUNTO_TM_PASSWORD_FILE=<your pyunto_tm_password_file>' -- npx -y @pyunto/tm-mcp@0.3.6. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج com.pyunto/time-management إلى مفتاح API؟

نعم. يتطلب PYUNTO_TM_API_KEY, PYUNTO_TM_PASSWORD, PYUNTO_TM_PASSWORD_FILE، وتضبطها في إعداداته.

هل com.pyunto/time-management مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون com.pyunto/time-management؟

ينشره pyunto. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.