eve Contentful Agent Template

eve Contentful Agent Template is a Slack-based content assistant built on the eve agent framework that lets teams draft, edit, and publish Contentful entries directly from Slack conversations. It runs on Vercel and is published by Vercel Labs under the MIT License.

What is eve Contentful Agent Template?

eve Contentful Agent Template is a Slack assistant for managing Contentful content, built on the eve agent framework and deployed on Vercel. It takes Contentful Management API credentials as input and produces Slack conversational output: drafted and edited entries, asset uploads, publication approval cards, and results presented as tables or charts. Vercel Drives provides a searchable synced copy of your content that the agent can also query with SQL. The template is published by Vercel Labs (vercel-labs) with an MIT License.

What makes it stand out?

• eve agent framework — the agent runs on eve, Vercel's agent stack; pnpm dev opens eve's interactive chat in your terminal for local testing.
• Contentful management — connects via CONTENTFUL_MANAGEMENT_TOKEN and CONTENTFUL_SPACE_IDS (one or multiple comma-separated space IDs) to read and edit entries and upload assets.
• Slack integration via Vercel Connect — the setup flow creates and installs a Slack app; you @mention the agent in a channel to start a conversation.
• Content search and sync on Vercel Sandbox — a searchable copy of your Contentful content is synced and queried with DuckDB SQL.
• Publication approval flow — edits are saved without publishing; by default a Slack card lists entries and assets going live, and any authenticated user can approve or cancel.
• Approval exemptions — supporting content types such as authors or callouts can be exempted from approval via CONTENTFUL_COMPONENT_TYPES.
• Per-user writing preferences — tone or language preferences are stored per user in a private Vercel Blob store.
• Private Blob storage — configured automatically during Vercel's project setup flow.

Who should use eve Contentful Agent Template?

• Content teams using Contentful: draft and edit entries from Slack instead of the Contentful web app, then review publication requests before content goes live.
• Editors managing assets: upload and process new assets; uploads are processed and published when added to content.
• Teams with house style rules: encode writing guidelines in agent/instructions.md, and the agent remembers each user's tone or language preferences.
• Developers evaluating agent templates: self-host and customize the agent code, model, and session limits in agent/agent.ts.

How does it work?

Deploy through Vercel's clone flow, which creates a Git repository and Vercel project. During setup you create and install a Slack app via Vercel Connect, configure a private Vercel Blob store, and supply the CONTENTFUL_MANAGEMENT_TOKEN and CONTENTFUL_SPACE_IDS environment variables. After deployment, add the agent to a Slack channel and @mention it. Locally, run pnpm install, vercel link, vercel env pull .env.local, and pnpm dev with Node.js 24 and pnpm; local sessions use just-bash without the Vercel Drives copy, so searches and SQL queries hit Contentful directly.

What can you do with eve Contentful Agent Template?

• Content editors: ask the agent to list content types in a space, then draft or edit entries and approve publication in Slack.
• Asset managers: add new assets and have them processed and published when attached to content.
• Analysts: ask SQL questions about synced content through DuckDB and get tables or charts back.
• Template customizers: set approval-exempt content types, configure website URL lookup with CONTENTFUL_PUBLIC_ORIGIN and CONTENTFUL_PAGE_ROUTES, and enable replies without mentions in chosen channels via SLACK_AUTO_REPLY_CHANNEL_IDS.

FAQ

Is eve Contentful Agent Template free?

Yes. The template is published by Vercel Labs under the MIT License, so the code is free to use and modify. You still need your own Contentful account, Management API token, and a Vercel project to deploy it.

Does it publish content automatically?

No. The agent saves edits without publishing. By default, publication requires approval in Slack, where a card lists the entries and assets that will go live, and any authenticated user can approve or cancel. Supporting content types can be exempted from approval.

What is required to deploy it?

You need a CONTENTFUL_MANAGEMENT_TOKEN with access to your configured spaces and one or more CONTENTFUL_SPACE_IDS. Vercel's setup flow also creates a Slack app via Vercel Connect and a private Vercel Blob store for user preferences.

Does local development match the Slack experience?

Not fully. Local sessions run with just-bash without access to content stored on Vercel Drives, so searches and SQL questions query Contentful directly. Search behavior and publication approval cards should be tested through the agent in Slack.