Bring Task Management
to OpenAI Agents SDK
Create your Vinkius account to connect Lunatask to OpenAI Agents SDK and start using all 8 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the Lunatask MCP Server?
Connect your Lunatask account to any AI agent to streamline your privacy-focused productivity. This MCP server enables your agent to create, update, and manage tasks, track habits, and log journal entries directly from natural language interfaces.
What you can do
- Task Creation — Add new tasks to specific Areas of Life with statuses like 'next' or 'later'
- Habit Tracking — Log completions for your daily habits to stay consistent with your goals
- Encrypted Journaling — Create secure, end-to-end encrypted journal entries directly from your conversation
- Metadata Inspection — List all tasks and notes to monitor your productivity structure and statuses
- Workflow Management — Update task priorities and move them through your personal workflow stages
Important Note on Privacy
Lunatask uses end-to-end encryption. While this API allows creating and updating content, it cannot read back the names or notes of your tasks once they are stored. The agent will only see technical metadata (IDs, dates, statuses).
How it works
- Subscribe to this server
- Enter your Lunatask Access Token
- Start managing your productivity from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Privacy-Conscious Professionals — Manage your tasks via AI without compromising the encryption of your content
- Goal-Oriented Individuals — Quickly track habits and log journal thoughts via natural language commands
- Power Users — Automate task creation and organizational metadata updates directly from your development tools
Built-in capabilities (8)
Add a new journal entry
Requires a name and an area_id. Create a new task
Delete a task
Get metadata for a specific task
List metadata for all notes
Note: Due to encryption, names and notes are not available via API. List metadata for all tasks
Log a completion for a habit
Update an existing task
Why OpenAI Agents SDK?
The OpenAI Agents SDK auto-discovers all 8 tools from Lunatask through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Lunatask, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
- —
Native MCP integration via
MCPServerSse, pass the URL and the SDK auto-discovers all tools with full type safety - —
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
- —
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
- —
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
Lunatask in OpenAI Agents SDK
Why run Lunatask with Vinkius?
The Lunatask connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 8 tools are ready to work instantly without any complex setup.
You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.
* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.
Explore our live AI Agents Analytics dashboard to see it all working
This dashboard is included when you connect Lunatask using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
Lunatask and 4,000+ other AI tools. No hosting, no code, ready to use.
Professionals who connect Lunatask to OpenAI Agents SDK through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.
Raw MCP | Vinkius | |
|---|---|---|
| Ready-to-use MCPs | Find and configure each manually | 4,000+ MCPs ready to use |
| Connection Setup | Manual coding & server setup | 1-click instant connection |
| Server Hosting | You host it yourself (needs 24/7 uptime) | 100% hosted & managed by Vinkius |
| Security & Privacy | Stored in plaintext config files | Bank-grade encrypted vault |
| Activity Visibility | Blind execution (no logs or tracking) | Live dashboard with real-time logs |
| Cost Control | Runaway AI token spend risk | Automatic budget limits |
| Revoking Access | Must delete files or code to stop | 1-click disconnect button |
How Vinkius secures
Lunatask for OpenAI Agents SDK
Every request between OpenAI Agents SDK and Lunatask is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.
Frequently asked questions
Why can't the agent read my task names?
Lunatask uses end-to-end encryption. Task names and note bodies are encrypted on your device before being sent to the server. The API only has access to metadata like IDs and statuses.
Where do I find my Area ID?
In the Lunatask desktop app, go to an Area's settings. The unique Area ID (UUID) is displayed there for use in the API.
Can I track habits using this agent?
Yes, use the track_habit_completion tool with the unique habit ID to log a successful completion event.
How does the OpenAI Agents SDK connect to MCP?
Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.
Can I use multiple MCP servers in one agent?
Yes. Pass a list of MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.
Does the SDK support streaming responses?
Yes. The SDK supports SSE and Streamable HTTP transports, both of which work natively with Vinkius.
MCPServerStreamableHttp not found
Ensure you have the latest version: pip install --upgrade openai-agents
Agent not calling tools
Make sure your prompt explicitly references the task the tools can help with.
Explore More MCP Servers
View all →
Ordergroove
9 toolsSubscription management for eCommerce — manage recurring orders and customer loyalty via Ordergroove.
Exa AI
12 toolsSearch the web with neural embeddings that understand meaning, not just keywords, and return the most relevant results for any query.
Checkr
8 toolsAutomate background checks via Checkr — screen candidates, monitor reports, and manage compliance directly from any AI agent.
Indy
12 toolsManage your freelance business with proposals, contracts, time tracking, and invoicing that covers the entire client lifecycle.