# Tana MCP for AI Agents AI Agent Connect > Tana MCP. Connect your AI to Tana to automate knowledge graph entries, manage supertags, and structure nested nodes. It turns your AI into a personal knowledge architect that handles the tedious manual work of organizing notes, tasks, and data fragments. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_85FZKjooAVN5eG19P2TZdvvM9KIL49m4crFHgTh1/ai-agent-connect - **Tags:** graph-database, ontologies, knowledge-graph, supertags, structured-data, personal-knowledge-management ## Description Tana MCP connects your AI to your personal knowledge graph to turn messy conversations into structured data. Instead of clicking through menus to create tags and nested lists, you can just tell your agent what to do. It handles the heavy lifting of building out your workspace, whether you're trying to map out a research project or organize a series of meeting notes. By using this connector via Vinkius, you give your agent the ability to act as a dedicated knowledge architect. It knows how to categorize thoughts, build hierarchies, and maintain the links between your ideas. It moves your information from a transient chat into a permanent, organized home where it actually becomes useful. ## Tools ### add_node_with_children Generates a parent node and multiple child nodes in a single action. It is perfect for building out complex outlines quickly. ### add_to_inbox Drops a new node directly into your Tana inbox for later review. It is the fastest way to capture quick thoughts or ideas. ### add_checkbox_task Adds a new todo item with a checkbox to your Tana inbox. You can set the initial completion status to keep your list updated. ### add_date_node Creates a new node with a specific date format in your Tana inbox. This helps you log chronological events without manual formatting. ### add_node Places a new node into a specific location like your library or inbox. You can give it a custom name to keep your workspace organized. ### add_node_reference Links a new node to an existing one in your graph. It creates a bidirectional path so you can navigate between related concepts easily. ### add_tagged_node Creates a new node and applies a specific supertag to it. This is how you categorize data into your predefined ontologies. ### add_url_bookmark Saves a web link as a dedicated node in your workspace. This keeps your research resources organized and accessible. ### add_node_with_fields Creates a supertagged node populated with specific JSON data. Use this to instantiate complex objects like people or projects with full attributes. ### define_supertag Creates a new supertag definition within your Tana schema. This allows your agent to understand your custom data structures. ## Prompt Examples **Prompt:** ``` Can you save this URL as a bookmark in my Tana workspace and tag it as a 'Source'? ``` **Response:** ``` I've added that bookmark to your Tana graph. **New Entry Added:** - **Node:** [Link to the website] - **Tag:** `#Source` - **Location:** Your Inbox I've also ensured it's linked to your active research project. ``` **Prompt:** ``` I need to start a new project for 'Q4 Marketing'. Create an outline with three sub-nodes: Strategy, Budget, and Timeline. ``` **Response:** ``` I've built that outline for you in Tana. **Structure Created:** - **Q4 Marketing** (Parent Node) - *Strategy* (Child Node) - *Budget* (Child Node) - *Timeline* (Child Node) Would you like me to add any specific tasks to the Strategy node? ``` **Prompt:** ``` Add a new task to my inbox: 'Review the latest API docs' and mark it as a checkbox. ``` **Response:** ``` Done! I've added that to your Tana inbox. **Task Added:** - [ ] Review the latest API docs It's now ready for you to check off when you're finished. ``` ## Capabilities ### Create supertagged nodes Automatically apply specific tags and metadata to new entries. ### Build nested outlines Generate parent nodes with multiple children in one go. ### Log tasks and checkboxes Turn action items from a chat directly into your Tana inbox. ### Link existing notes Create references to keep your knowledge graph interconnected. ### Bookmark external URLs Save web resources as dedicated nodes instead of loose links. ### Grow your knowledge base schema Create new categories of data for your agent to understand. ## Use Cases ### Turning meeting notes into action items A project manager asks the agent to 'Create a Meeting Minutes node and add 4 checkbox tasks as children.' The agent uses add_node_with_children and add_checkbox_task to build the plan. ### Automating research bookmarking A researcher asks the agent to 'Save these 5 links as bookmarks and tag them with #Research.' The agent uses add_url_bookmark and add_tagged_node to organize the workspace. ### Building complex hierarchies from a brain dump A student provides a messy list of biology topics. The agent uses add_node_with_children to create a structured hierarchy of nested nodes in the Tana graph. ### Populating a project database A developer asks the agent to 'Add a new bug report with the Issue supertag and the URL.' The agent uses add_node_with_fields and add_url_bookmark to update the database. ## Benefits - Stop manual data entry by letting your agent use add_node_with_fields to populate complex objects with specific attributes automatically. - Build complex outlines in seconds by using add_node_with_children to generate parent and child nodes in a single step. - Keep your research organized by using add_url_bookmark to save web resources as structured nodes instead of loose links. - Maintain a clean workspace by using add_to_inbox to capture fleeting ideas and add_node to place them in the right spot. - Grow your knowledge base schema by using define_supertag to let your agent understand and create new categories of data. - Connect related concepts across your graph using add_node_reference to ensure your information stays interconnected and easy to navigate. ## How It Works The bottom line is you get an AI that builds and maintains your knowledge graph for you. 1. Add the Tana module to your Vinkius workspace. 2. Paste your TANA_API_TOKEN from your Tana Plus or Pro settings into your local environment. 3. Ask your agent to organize notes, create tasks, or build hierarchies in your graph. ## Frequently Asked Questions **How does the Tana MCP help with my personal knowledge management?** It lets your AI agent interact directly with your Tana graph. Instead of you manually moving data, your agent can create notes, apply supertags, and build hierarchies based on your instructions. **Can I use the Tana MCP to create complex nested outlines?** Yes. Your agent can generate a parent node and multiple child nodes in a single command, making it much faster to build out project structures or outlines. **Does the Tana MCP support custom supertags?** Yes, it can define new supertags in your schema. This means your agent can learn your specific organizational rules and apply them to new data automatically. **Can my AI agent bookmark websites in Tana?** Absolutely. You can ask your agent to save any URL as a dedicated node, which keeps your research links organized and searchable within your graph. **Is the Tana MCP good for managing my daily tasks?** It's great for this. Your agent can turn conversation points into checkbox tasks in your Tana inbox, helping you capture action items without leaving your chat. **What kind of Tana account do I need for this Connector?** To use the API required for this Connector, you'll need a Tana Plus or Tana Pro account. **Can it apply Supertags with pre-filled fields?** Yes. Use `add_node_with_fields` to create a node with a specific Supertag and populate its attributes in a single call. **Are there limits on nested hierarchies?** No practical limits beyond your token window. The `add_node_with_children` tool accepts arrays of child nodes and populates the hierarchy in a single request. **Which Tana plan is required?** API access is available on Tana Plus and Pro plans. Free accounts do not have API tokens. Generate your token from Workspace Settings in the Tana web app.