How to Use the Craft (Docs & Notes) MCP in OpenAI Agents SDK

Q: How do I find tasks in Craft (Docs & Notes) using OpenAI Agents SDK?

You call the listtasks tool within your agent logic. It gathers your cross-workspace checklists and feeds them back into your Python application.

Q: Can OpenAI Agents SDK edit pages in Craft (Docs & Notes) automatically?

Yes, it uses updatedocument to mutate existing files. Your agent pushes changes directly to your account with typed safety.

Q: How do I list my documents via this server?

Use the listdocuments tool. It identifies your workspace routing to give you a clear view of your available file structure.

Build production agents using OpenAI Agents SDK that modify your Craft (Docs & Notes) workspace through managed tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Craft (Docs & Notes) MCP to OpenAI Agents SDK

Create your Vinkius account to connect Craft (Docs & Notes) to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Craft (Docs & Notes) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full document lifecycle control

Your agent can build new pages or wipe old ones clean using `create_document` and `delete_document`. It handles the heavy lifting of payload generation without manual input. Updating existing content is just as simple. The `update_document` tool lets your agent swap out values across your workspace while the SDK validates every action.

Task and note management

Stop digging through your dashboard to find pending items. Use `list_tasks` to pull active checklists directly into your agent's memory for processing. Need a quick summary of your day? Trigger `get_daily_note` to fetch your latest entries. This MCP Server keeps your notes ready for your agent to read.

Structured workspace navigation

Locate specific files by calling `list_documents` to scan your account. It maps out your workspace, so your agent knows exactly where to look for data. When you need to find something specific, `search_documents` filters your text queries. It returns the right node so you can read or edit details without searching manually.

Setup guide

Set up Craft (Docs & Notes) MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Craft (Docs & Notes) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Craft (Docs & Notes) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Craft (Docs & Notes) tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Craft (Docs & Notes) Agent",
            instructions="You have access to Craft (Docs & Notes) tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Craft. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Craft (Docs & Notes) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Craft (Docs & Notes) MCP in OpenAI Agents SDK

You call the `list_tasks` tool within your agent logic. It gathers your cross-workspace checklists and feeds them back into your Python application.

Yes, it uses `update_document` to mutate existing files. Your agent pushes changes directly to your account with typed safety.

Absolutely. The SDK validates every tool execution before it hits the API. This prevents your agent from making unexpected changes to your docs.

Use the `list_documents` tool. It identifies your workspace routing to give you a clear view of your available file structure.

Your document content stays encrypted in transit. This MCP Server only touches your raw text and JSON payloads, never storing your private notes on our infrastructure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript